Xerox Control Program-Five (CP-V) 

Xerox 560 and Sigma 6/7/9 Computers 



System Programming 
Reference Manual 



EROXEROXEROXEROXEROXEROXERO 
XEROXEROXEROXEROXEROXEROXERC 
OXER0XER0XER0XER0XER0XER0XER 
ROXEROXEROXEROXEROXEROXEROXEI 
'EROXEROXEROXEROXEROXEROXEROXI 
XEROXEROXEROXEROXEROXEROXERC! 
DXEROXEROXEROXEROXEROXEROXERC 
^OXEROXEROXEROXEROXEROXEROXER 
EROXEROXEROXEROXEROXEROXEROXE 
(EROXEROXEROXEROXEROXEROXEROX 
)XEROXEROXEROXEROXEROXEROXERO; 
DXEROXEROXEROXEROXEROXEROXERC 
ROXEROXEROXEROXEROXEROXEROXEf 
EROXEROXEROXEROXEROXEROXEROXI 
iXEROXEROXEROXEROXEROXEROXERO) 

DXEROXEROXEROXEROXEROXEROXERC 
?OXEROXEROXEROXEROXEROXEROXER 
EROXEROXEROXEROXEROXEROXEROXE 
(EROXEROXEROXEROXEROXEROXEROXI 



90 31 13A 



Xerox Corporation \/ |~r"l|T*\\/ 

7Q1 South Aviation Boulevard Allxl JA 

El Segundo, California 90245 
213 679-4511 



Xerox Control Program-Five (CP-V) 

Xerox 560 and Sigma 6/7/9 Computers 



System Programming 
Reference Manual 



FIRST EDITION 

90 31 13A 
October 1974 



Price: $8.25 



©Xerox Corporation, 1974 Printed in U.S.A. 



NOTICE 



This manual documents the COO version of CP-V. The manual contains new information as well as information that 
was formerly documented in other CP-V manuals. A change in text from that of the BOO manuals is indicated by a 
vertical line in the margin of the page. 

Information that was formerly documented in the CP-V/SM Reference Manual, 90 16 74, and that is now documented 
here includes: 

Bootstrap and patching operations 
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On-line peripheral diagnostic facilities 

Xerox standard object language 
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The documentation of real-time facilities was removed from the CP-V/BP Reference Manual, 90 17 64, and is now 
documented in this manual. 

This manual contains three new sections of information —a chapter on transaction processing facilities, an appendix 
of screech codes, and an appendix on the Xerox 560 Remote Assist Station. 
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PREFACE 

This manual describes the CP-V features that are designed to aid the system programmer in the development, 
maintenance, and modification of the CP-V system. 

Manuals describing other features of CP-V are outlined below: 

• The CP-V System Management Reference Manual, 90 16 74, is the principal source of reference informa- 
tion for the system management features of CP-V. It defines the rules for generating a CP-V system 
(SYSGEN), authorizing users, maintaining user accounting records, maintaining the file system, monitor- 
ing system performance, and other related functions. 

• The CP-V Batch Reference Manual, 90 17 64, is the principal source of reference information for the batch 
processing features of CP-V (i.e., job control commands, system procedures, I/O procedures, program 
loading and execution, debugging aids, and service processors). 

• The CP-V Time-Sharing Reference Manual, 90 09 07, is the principal source of information for the time- 
sharing features of CP-V. It defines the rules for using the Terminal Executive Language and other 
terminal processors. 

• The CP-V Time-Sharing User's Guide, 90 16 92, describes how to use the various time-sharing features. 
It presents an introductory subset of the features in a format that allows the user to learn the material by 
using the features at a terminal as he reads through the document. 

• The CP-V Remote Processing Reference Manual, 90 30 26, is the principal source of information about the 
remote processing features of CP-V. All information about remote processing for all computer personnel 
(remote and local users, system managers, remote site operators, and central site operators) is included in 
the manual. 

• The CP-V Transaction Processing Reference Manual, 90 31 12, provides information about dynamically 
modifying andqueryinga central database in a transaction processing environment. The manual is addressed 
to system managers, database administrators, applications programmers, and computer operators. 

• The CP-V Operations Reference Manual, 90 16 75, is the principal source of reference information for 
CP-V computer operators. It defines the rules for operator communication (i.e., key-ins and messages), 
system start-up and initialization, job and system control, peripheral device handling, recovery and file 
preservation. 

• The CP-V Common Index (90 30 80) is an index to all of the above CP-V manuals. 

Information for the language and application processors that operate under CP-V is also described in separate man- 
uals. These manuals are listed on the Related Publications page of this manual. 



IX 



COMMAND SYNTAX NOTATION 



Notation conventions used in command specifications and examples throughout this manual are listed below. 



Notation 


Description 


lowercase letters 


Lowercase letters identify an element that must be replaced with a 
user-selected value. 




CRndd could be entered as CRA03. 


CAPITAL LETTERS 


Capital letters must be entered as shown for input, and will be printed as 




shown in output. 




DPndd means "enter DP followed by the values for ndd". 


[] 


An element inside brackets is optional. Several elements placed one under 
the other inside a pair of brackets means that the user may select any one or 
none of those elements. 




[KEYM] means the term "KEYM" may be entered. 


U 


Elements placed one under the other inside a pair of braces identify a re- 
quired choice. 




| . , r means that either the letter A or the value of id must be entered. 


... 


The horizontal ellipsis indicates that a previous bracketed element may be 
repeated, or that elements have been omitted. 




name [, name]. . . means that one or more name values may be 
entered, with a comma inserted between each name value. 


• 


The vertical ellipsis indicates that commands or instructions have been 
omitted. 




MASK2 DATA, 2 X'lEF' 




! means that there are one or more state- 

„. /TC ilvATA o riA/i/cnw ments omitted between the two DATA 
BYTE DATA, 3 BA(L(59)) .. 

directives. 


Numbers and 
special characters 


Numbers that appear on the line (i.e., not subscripts), special symbols, and 
punctuation marks other than dotted lines, brackets, braces, and underlines 
appear as shown in output messages and must be entered as shown when input. 




(value) means that the proper value must be entered enclosed in 
parentheses; e.g., (234). 


Subscripts 


Subscripts indicate a first, second, etc. , representation of a parameter that 
has a different value for each occurrence. 




sysid],sysid2fSysid3 means that three successive values for sysid 
should be entered, separated by commas. 


Superscripts 


Superscripts indicate shift keys to be used in combination with terminal keys, 
c is control shift, and s is case shift. 




L cs means press the control and case shift (CONTROL and SHIFT) and 
the L key. 


Underscore 


All terminal output ?s underscored; terminal input is not. 




!RUN means that the exclamation point was sent to the terminal, but 
RUN was typed by the terminal user. 


©@© 


These symbols indicate that an ESC (©), carriage return (©), or line feed 
(©) character has been sent. 




'EDIT ©means that, after typing EDIT, a carriage return character 
nas been sent. 



GLOSSARY 



ANS tape a tape that has labels written in American 
National Standard (ANS) format. 

batch job a job that is submitted tothe batch job stream 
through the central site card reader, through an on-line 
terminal (using the Batch processor), or through a re- 
mote terminal. 

binary input input from the device to which the BI 

(binary input) operational label is assigned. 

concatenation a process whereby a number of files with 
the same filename and format are treated as one logical 
file. Concatenation is only applicable to ANS tapes. 

conflicting reference' a reference lo a symbolic name 
that has more than one definition. 

control command any control message other than a key-in. 
A control command may be input via any device 
to which the system command input function has been 
assigned (normally a card reader). 

control message any message received by the monitor 
that is either a control command or a control key-in. 

cooperative a monitor routine that transfers information 
between a user's program and disk storage (also see 
"symbiont"). 

data control block (DCB) a table in the user's program 
that contains the information used by the monitor in 
the performance of an I/O operation. 

external reference a reference to a declared symbolic 
name that is not defined within the object module in 
which the reference occurs. An external reference 
can be satisfied only if the referenced name is de- 
fined by an external load item in another object 
module. 

file extension a convention that is used when certain 
system output DCBs are opened. Use of this conven- 
tion causes the file (on RAD, tape, disk pack, etc. ) 
connected to the DCB to be positioned to a point just 
following the last record in the file. When additional 
output is produced through the DCB, it is added to the 
previous contents of the file, thereby extending the 
file. 

function parameter table (FPT) a table through which a 
user's program communicates with a monitor function 
(such as an I/O function). 

ghost job a job that is neither a batch nor an on-line 
program. It is initiated and logged on by the monitor, 
the operator, or another job and consists of a single 
job step. When the ghost program exits, the ghost is 
logged off. 



global symbol a symbolic name that is defined in one 

program module and referenced in another. 

GO file a temporary disk storage file consisting of re- 
locatable object modules formed by a processor. 

granule a block of disk sectors large enough to contain 
512 words (a page) of stored information. 

job information table (JIT) a table associated with each 
active job. The table contains accounting, memory 
mapping, swapping, terminal DCB(M:UC), and tempo- 
rary monitor information. 

job step a subunit of job processing such as compilation, 
assembly, loading, or execution. Information from cer- 
tain commands (JOB, LIMIT, and ASSIGN) and all 
temporary files created during a job step are carried 
from one job step to the next but the steps are otherwise 
independent. 

key a data item consisting of 1-31 alphanumeric char- 
acters that uniquely identifies a record. 

key-in information entered by the operator via a 
keyboard. 

language processor a program that translates a user's 
source language program into an object language 
program. 

library load module a load module that maybe combined 
with relocatable object modules, or other library load 
modules, to form a new executable load module. 

linking loader a program that is capable of linking and 
loading one or more relocatable object modules and 
load modules. 

load map a listing of loader output showing the location 
or value of all global symbols entering into the load. 
Also shown are symbols that are not defined or have 
multiple definitions. 

load module (LM) an executable program formed by the 
linking loader, using relocatable object modules 
(ROMs) and/or modules (LMs) as input information. 

logical device a peripheral device that is represented 
in a program by an operational label (e.g., BI or PO) 
rather than by specific physical device name. 

logical device stream an information stream that may 

be used when performing input from or output to a sym- 
biont device. At SYSGEN, up to 15 logical device 
streams are defined. Each logical device stream is 
given a name (e.g., LI, PI, CI), each is assigned to 
a default physical device, and each is given default 
attributes. The user may perform I/O through a logical 



device stream with the default physical device and 
attributes or he may change the physical device and/or 
attributes to satisfy the requirements of his job. 

monitor a program that supervises the processing, load- 

ing, and execution of other programs. 

object language the standard binary language in which 

the output of a language processor is expressed. 

object module the series of records containing the load in- 

formation pertaining to a single program or subprogram 
(i.e., from the beginning to the end). Object modules 
serve as input to the Load processor or Link processor. 

on-line job a job that is submitted through an on-line 
terminal by a command other than the BATCH command. 

operational label a symbolic name used to identify a 

logical system device. 

overlay loader a monitor routine that loads and links 
elements of overlay programs. 

overlay program a segmented program in which the ele- 
ment (i.e., segment) currently being executed may 
overlay the core storage area occupied by a previously 
executed element. 

patch a symbolic representation of a correction to the 
system that is used to temporarily correct the system 
without necessitating a reassembly. 

physical device a peripheral device that is referred to 
by a name specifying the device type, I/O channel, 
and device number (also see "logical device"). 

program product a compiler or application program that 
has been or will be released by Xerox, but is not re- 

| quired by all users and is therefore made available by 

Xerox on an optional basis. Program products are pro- 
vided only to those users who execute a License Agree- 

I ment for each applicable installation. 

prompt character a character that is sent to the terminal 
by an on-line processor to indicate that the next line 
of input may be entered. 

protective mode a mode of tape protection in which only 
ANS expired tapes may be written on through an ANS 
DCB; no unexpired ANS tape maybe written on through 
a non-ANS DCB; all ANS tapes must be initialized by 
the Label processor; no tape serial number specification 
is allowed at the operator's console; specification of an 
output serial number in an ANS DCB forces processing 
to be done only on a tape already having that serial 
number; tapes mounted as IN may not be written; and 
tapes mounted as other than IN must have a write ring. 
(See "semiprotective mode". ) 

public library a set of library routines declared at 
SYSGEN to be public (i.e., to be used in common by 
all concurrent users). 



reentrant an attribute of a program that allows the 
program to be shared by several users concurrently. 
Shared processors in CP-V are reentrant. That is, each 
instance of execution of the single copy of the pro- 
gram's instructions has a separately mapped copy of the 
execution data. 

relative allocation allocation of virtual memory to a 

user program starting with the first unallocated page 
available. 

relocatable object module (ROM) a program or subpro- 
gram in object language generated by a processor such 
as Meta-Symbol or FORTRAN. 

remote processing an extension of the symbiont system 
that provides flexible communication between CP-V 
and a variety of remote terminals. 

resident program a program that has been loaded into a 
dedicated area of core memory. 

response time the time between the completion of termi- 
nal input and the first program activation. 

scheduler a monitor routine that controls the initiation 
and termination of all jobs, job steps, and time slice 
quanta. 

secondary storage any rapid-access storage medium other 
than core memory (e.g., RAD storage). 

semi -protective mode a mode of tape protection in which 
a warning is posted to the operator when an ANS DCB 
attempts output on a non-ANS tape or an unexpired ANS 
tape, when a non-ANS DCB attempts output on an un- 
expired ANS tape, or when a tape mounted as INOUT 
has no write ring. The operator can authorize the over- 
writing of the tape or the override of INOUT through a 
key-in (OVER and READ). ANS tapes may be ini- 
tialized by the Label processor or may be given labels 
as the result of an operator key-in; tape serial number 
specification is allowed at the operator's console; and 
specification of an output serial number in an ANS 
DCB forces processing to be done only on a tape al- 
ready having that serial number unless the operator 
authorizes an overwrite. (See "protective mode". ) 

shared processor a program (e.g., FORTRAN) that is 
shared by all concurrent users. Shared processors must 
be established during SYSGEN or via DRSP. 

source language a language used to prepare a source 
program suitable for processing by an assembler or 
compiler. 

special shared processor a shared processor that may be 
in core memory concurrently with the user's program 
(e.g., Delta, TEL, or the FORTRAN library). 

specific allocation allocation of a specific page of 
unallocated virtual memory to a user program. 



SRI, SR2, SR3, and SR4 see "system register", below. 

static core module a program module that is in core 
memory but is not being executed. 

stream-id the name of a logical device stream. 

symbiont a monitor routine that transfers information 
between disk storage and a peripheral device inde- 
pendent of and concurrent with job processing. 

symbolic input input from the device to which the SI 

(symbolic input) operational label is assigned. 

symbolic name an identifier that is associated with 
some particular source program statement or item so 
that symbolic references maybe made to it even though 
its value may be subject to redefinition. 

SYSGEN see "system generation", below. 

system generation (SYSGEN) the process of creating an 
operating system that is tailored to the specific require- 
ments of an installation. The major SYSGEN steps 



include: gathering the relevant programs, generating 
specific monitor tables, loading monitor and system 
processors, and writing a bootable system tape. 

system library a group of standard routines in object- 
language format, any of which may be incorporated in 
a program being formed. 

system register a register used by the monitor to commu- 
nicate information that may be of use to the user pro- 
gram (e.g., error codes). System registers SRI, SR2, 
SR3, and SR4 are current general registers 8, 9, 10, 
and 11, respectively. 

task control block (TCB) a table of program control in- 
formation built by the loader when a load module is 
formed. The TCB is part of tfie load module and con- 
tains the data required to allow reentry of library rou- 
tines during program execution or to allow entry to the 
program in cases of traps, breaks, etc. The TCB is 
program associated and not task associated. 

unsatisfied reference a symbolic name that has been ref- 
erenced but not defined. 
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1. INTRODUCTION 



CP-V SERVICES 

Control Program-Five (CP-V) is a comprehensive operating 
system designed for use with Sigma 6/7/9 and Xerox 560 
computers and a variety of peripheral equipment. CP-V 
offers: 

• On-line time-sharing, batch processing, remote pro- 
cessing, transaction processing, and real-time services. 



Ability to handle a large number of concurrent users. 



Processor 



TEL 



EASY 



Edit 



Function 

Executive language control of all 
terminal activities. (On-line only.) 

Creation, manipulation, and execution 
of FORTRAN and BASIC programs and 
data files. (On-line only.) 

Composition and modification of pro- 
grams and other bodies of text. (On- 
line only. ) 



• High efficiency due to hardware relocation map, 
shared reentrant processors, multiple I/O processors, 
and device pooling. 



A complete recovery system coupled with preservation 
of user files to provide fast restart following hardware 
or software malfunction. 



For on-line users: highly efficient and extensive soft- 
ware, file saving feature, fast response time. 



For batch users: on-line entry, local and remote entry 
to an efficient multiprogramming batch job scheduler. 



FORTRAN IV Compilation of Extended FORTRAN IV 

programs. 

COBOL Compilation of ANS COBOL programs. 

Meta-Symbol Assembly of high-level assembly lan- 

guage programs. 

BASIC Compilation and execution of programs 

or direct statements written in an ex- 
tended BASIC language. 

APL Interpretation and execution of pro- 

grams written in the APL language. 

FLAG Compilation of fast "load-and-go" 

FORTRAN programs. 



• For installation managers: thorough system monitoring 
and reporting, control and tuning ability, extensive 
error checking and recovery features. 



• For all users: comprehensive accounting and a com- 
plete set of powerful processors. 



TIME-SHARING AND BATCH PROCESSING 

CP-V allows multiple on-line terminal users to concurrently 
create, debug, and execute programs. Concurrent to time- 
sharing, CP-V allows up to 16 batch processing jobs to 
execute in its multiprogramming environment. An efficient 
multi-batch scheduler selects batch jobs for execution 
according to priority, job requirements, and availability of 
resources. Batch jobs may be submitted to this scheduler 
from a local batch entry device such as a card reader, from 
an on-iine user's terminal, or from a remote site such as a 
remote batch terminal or another computer. 

Time-sharing and batch users have access to a variety 
of powerful and comprehensive language processors and 
facilities. These processors and facilities are listed 
below. 



FDP 



Delta 



COBOL On-line 
Debugger 

PCL 



Link 
Load 

Batch 

Manage 
SL-1 

CIRC 



Debugging of Extended FORTRAN IV 
programs. 

Debugging of programs at the assembly 
language level. (On-line only.) 

Debugging of ANS COBOL programs. 
(On-line only. ) 

Transfer (and conversion) of data be- 
tween peripheral devices. 

Linkage of programs for execution. 

Linkage of programs for execution. 
(Batch only.) 

Submission of batch jobs via an on- 
line terminal or another batch job. 

File retrieval, updating, and reporting. 

Compilation of programs written in a 
language designed specifically for 
digital or hybrid simulation. 

Analysis of electronic circuits. 
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Processor Function 

EDMS Organization, storing, updating, and 

deletion of information in a centralized 
data base. 

Sort/Merge Sorting and/or merging of records in 

one or more files. 

GPDS Experimentation with and evaluation of 

system methods, processes, and designs. 
(Batch only.) 

REMOTE PROCESSING 

The remote processing system is an extension of the CP-V 
symbiont system. Its purpose is to provide for flexible com- 
munication between CP-V and a VGrietyof remote terminals. 
These terminals can range from a simple card reader, card 
punch, and line printer combination to another computer 
system with a wide variety of peripheral devices. AnyCP-V 
user (batch, on-line, ghost) can communicate with any 
number of devices at one or several remote sites. Because 
CP-V can act as a central site to some remote sites and 
simultaneously as a remote terminal to other computers, 
the remote processing facilities encourage the construction 
of communication networks. 



TRANSACTION PROCESSING 

The transaction processing feature of CP-V is an efficient 
and economical approach to centralized information pro- 
cessing and is a generalized package that is designed to 
meet the requirements of a variety of business applications. 
Transaction processing facilities provide an environment in 
which several users at remote terminals may enter business 
transactions, simultaneously utilizing a common data base. 
The transactions are processed immediately, as they are 
received, by application programs written especially for 
the particular installation. As necessary, reports may 
then be created and sent to an appropriate terminal. 



REAL-TIME PROCESSING 

The real-time services provided by CP-V allow users to 
connect interrupts to mapped programs, control the state of 
interrupts (e.g., trigger, arm/disarm, enable/disable), 
clear interrupts either at the time of occurrence or upon 
completion of processing, and disconnect interrupts no 



longer required. Users may also request that a mapped 
program be held in core in order to reduce the time required 
to respond to an external event (via an interrupt) or to 
allow various forms of special I/O to occur. Programs may 
be connected to one of the monitor's clocks such that after 
a specified period of time, a specified routine is entered. 
In addition, dedicated foreground memory may be used as 
inter-program communication buffers or as dedicated memory 
for unmapped, master mode programs which may be directly 
connected to external interrupts or real-time clocks. 



SYSTEM PROGRAMMING FACILITIES 

This manual describes the CP-V features that are designed 
to aid the system programmer in the development, main- 
tenance, and modification of the CP-V system. The facil- 
ities described in this manual aid the system programmer 
in the following areas: 

• Modification of the CP-V operating system at the 
instruction level at boot-time. 

• Reconfiguration of peripheral devices at boot-time. 

• Analysis of crash dumps to determine the cause of a 
system crash. 

• Creation and modification of the error message file 
for the CP-V monitor overlays while the system is 
operational. 

• Listing and analysis of hardware and software mal- 
functions occurring during system operation. 

• Development of shared processors such as compilers, 
assemblers, command language processors, and 
debuggers. 

• Replacement, creation, and deletion of shared pro- 
cessors and monitor overlays while the system is 
operational. 

• Development of peripheral hardware diagnostic 
programs. 

• Development of real-time programs. 

• Support of transaction processing facilities. 

• Implementation of remote diagnostics for the Xerox 560. 



System Programming Facilities 



2. SYSTEM OVERVIEW 



INTRODUCTION 



COMMAND PROCESSORS 



The CP-V operating system consists of a monitor and a 
number of associated processors (Figure 1). The monitor 
provides overall supervision of program processing. The 
associated processors provide specific functions such as 
compilation, execution, and debugging. 



The four processors in this group are: LOGON/LOGOFF, 
EASY, TEL, and CO. The first of these processors is avail- 
able to on-line and batch users, the second and third are 
available to on-line users only, and the last is available to 
batch users only. 



PROCESSORS 

The CP-V system is illustrated in Figure 1 at two levels. The 
upper level lists the various monitor routines. The lower 
level lists the various processors. The processors are de- 
scribed in the following paragraphs. 



LOGON/LOGOFF 

LOGON admits on-line users to the system and connects 
the user's terminal either to TEL or to an alternative pro- 
cessor, such as BASIC, that has been selected by the user. 
LOGOFF disconnects a user from the system and does the 
final cleanup and accounting. 
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Figure 1. CP-V Operating System 
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EASY 



CONTROL 



EASY is a shared processor that enables the user to create, 
edit, execute, save, and delete program files written in 
BASIC or FORTRAN. EASY also allows the user to create 
and manipulate EBCDIC data files. Although intended pri- 
marily for Teletype® operations, EASY can be used with 
any type of on-line terminal supported by the system. 
(Reference: EASY/LN,OPS Reference Manual, 90 18 73.) 



The Control processor provides control over system perfor- 
mance. CP-V has a number of performance measurements 
built directly into the system. Commands of the Control 
processor enable the system manager to display these mea- 
surements and to "tune" the system as needed by setting new 
values for the parameters that control system performance. 
(Reference: CP-V/SM Reference Manual, 90 16 74. ) 



TERMINAL EXECUTIVE LANGUAGE 

The Terminal Executive Language' (TEL) is the principal 
terminal language for CP-V. Most activities associated 
with FORTRAN, COBOL and assembly language program- 
ming can be carried out directly in TEL. These activities 
include such major operations as composing programs and 
other bodies of text, compiling and assembling programs, 
linking object programs, initiating execution, and de- 
bugging programs. They also include such minor operations 
as saving and restoring core images of programs for which 
execution was interrupted, determining program status, and 
setting simulated tab stops. (Reference: CP-V/TS Refer- 
ence Manual, 90 09 07.) 



CONTROL COMMAND INTERPRETER 

The Control Command Interpreter is the batch counterpart 
of TEL. It provides the batch user with control over the 
processing of batch programs just as TEL provides on-line 
users with control over the processing of on-line programs. 
(Reference: CP-V/BP Reference Manual, 90 17 64. ) 



SYSTEM MANAGEMENT PROCESSORS 

System management processors furnish the manager of a 
CP-V installation with on-line control of the system. Four- 
teen system management processors are supplied. 



SUPER 

Super gives the system manager control over the entry of 
users and the privileges extended to users. Through the use 
of Super commands, the system manager may add and delete 
users, specify how much core and disk storage space a 
user will have, specify how many central site magnetic 
tape units a user will have, grant certain users, such as 
system programmers, special privileges, (e.g., the privilege 
of examining, accessing, and changing the monitor), and 
individually authorize or deny access to the various pro- 
cessors for each user. Super is also used to create and de- 
lete remote processing workstations. (Reference: CP-V/SM 
Reference Manual, 90 16 74.) 
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RATES 

The Rates processor allows the system manager to set rel- 
ative charge weights on the utilization of system services. 

Specific items to which charge weights may be assigned 
include 

1. CPU time. 

2. CPU time multiplied by core size. 

3. Terminal interactions. 

4. I/O CALs. 

5. Console minutes. 

6. Tapes and packs mounted. 

7. Page-date storage. 

8. Peripheral I/O cards plus pages. 

(Reference: CP-V/SM Reference Manual, 90 16 74.) 



FIX 



The Fix processor enables the system manager to repair or 
delete damaged file directories. It also provides HGP 
reconstruction for private disk pack sets and the public 
file system. (Reference: CP-V/OPS Reference Man- 
ual, 90 16 75.) 



FILL 

The FILL processor performs three basic file maintenance 
functions: 

1. It copies files from disk to tape as a backup. 

2. It restores files from tape to disk. 

3. It deletes files from disk. 

(Reference: CP-V/OPS Reference Manual, 90 16 75.) 



Processors 



FSAVE 



GRANULE ACCOUNTING CLEANUP PROCESSOR (GAC) 



The Fast Save (FSAVE) processor is designed to save disk 
files on tape at or near tape speed. The processor is faster 
than any other file saving procedure under CP-V. (Ref- 
erence: CP-V/OPS Reference Manual, 90 16 75.) 



FRES 



The File Restore (FRES) processor is designed to restore to 
disk files that were saved on tape by FSAVE or Fill. (Ref- 
erence: CP-V/OPS Reference Manual, 90 16 75.) 



VOLINIT 

VOLINIT provides for the initialization of public and pri- 
vate disk packs. It is used to establish serial numbers and 
ownership, to write headers and other system information in 
selected areas of the volumes, and to test the surface 
of the disks and select alternate tracks to be used in 
place of flawed tracks. (Reference: CP-V/OPS Reference 
Manual, 90 16 75.) 



LABEL 



The Granule Accounting Cleanup (GAC) processor correlates 
information between the file DISKPOOL and the account 
authorization file, :USERS. DISKPOOL is created by the 
FSAVE processor and contains specific account information. 
Each account record in DISKPOOL contains an entry for 
accumulated public disk pack granules and an entry for ac- 
cumulated RAD granules. When GAC is run, these accumu- 
lated values are compared against the maximum values for 
the corresponding accounts in the :USERS file and the user's 
entry in the :USERS file is updated to reflect the latest 
accumulated values for RAD and disk. When the accumu- 
lated RAD or disk granules exceed the corresponding maxi- 
mum values, this fact is noted in the report that is produced 
by the GAC processor. (Reference: CP-V/OPS Reference 
Manual, 90 16 75.) 



DEVDMP 

The Device Save/Restore processor (DEVDMP) is a stand- 
alone utility program designed to dump entire disk volumes 
to magnetic tapes for restoration at a later time. Restora- 
tion may only be made to an identical storage unit. (Ref- 
erence: CP-V/OPS Reference Manual, 90 16 75.) 



The Label processor initializes ANS tapes by writing ANS 
formatted labels. It may also be used to create "unlabeled" 
tapes from new tapes to be used as scratch tapes and to 
print the contents of the header and trailer labels of 
labeled tapes or the first 80 bytes of each block on un- 
labeled tapes. (Reference: CP-V/OPS Reference Man- 
ual, 90 16 75.) 



LANGUAGE PROCESSORS 

Language processors translate high-level source code into 
machine object code. Eight processors of special importance 
are described below. All of these can be used in both on- 
line and batch mode. 



STATS 

The STATS processor displays and collects performance data 
on a running system and produces snapshot files to be dis- 
played by the report generator Summary. (Reference: 
CP-V/SM Reference Manual, 90 16 74.) 



SUMMARY 

The Summary processor provides a global view of system 
performance by formatting and displaying the statistical 
data collected by STATS. (Reference: CP-V/SM Reference 
Manual, 90 16 74.) 



XEROX EXTENDED FORTRAN IV 

The Xerox Extended FORTRAN IV language processor con- 
sists of a comprehensive algebraic programming language, a 
compiler, and a large library of subroutines. The language 
is a superset of most available FORTRAN languages, con- 
taining many extended language features to facilitate pro- 
gram development and checkout. The compiler is designed 
to produce efficient object code, thus reducing execu- 
tion time and core requirements, and to generate extensive 
diagnostics to reduce debugging time. The library contains 
over 235 subprograms and is available in a reentrant ver- 
sion. Both the compiler and run-time library are reentrant 
programs that are shared among all concurrent users to re- 
duce the utilization of critical core resources. 



SYSCON 

SYSCON is a system control processor that can be used to 
partition resources from the system, to return resources to 
the system, and to display the status of the various system 
resources. SYSCON can also be used to build, update, or 
display the M:MODNUM file, a file which contains device 
and controller model numbers. (Reference: CP-V/SM Ref- 
erence Manual, 90 16 74.) 



The principal features of Xerox Extended FORTRAN IV are 
as follows: 

• Extended language features to reduce programming 
effort and increase range of applications. 

• Extensive meaningful diagnostics to minimize debug- 
ging time. 



Processors 



• In-line symbolic code to reduce execution time of 
critical parts of the program. 

• Overlay organization for minimal core memory 
utilization. 

• Compiler produced reentrant programs. 

(Reference: Extended FORTRAN IV/LN Reference Man- 
ual, 90 09 56, and Extended FORTRAN IV/OPS Reference 
Manual, 90 1 1 43. ) 



META-SYMBOL 

Meta-Symbol is a procedure-oriented macro assembler. It 
has services that are available only in sophisticated macro 
assemblers and a number of special features designed to 
permit the user to exercise dynamic control over the para- 
metric environment of assembly. It provides users with a 
highly flexible language with which to make full use of 
the available hardware capabilities. 

Meta-Symbol may be used in either batch or on-line mode. 
When used in on-line mode, the assembler allows programs 
to be assembled and executed on-line but does not allow 
conversational interaction. 



on the length of a certain list. He can inquire about a 
specific symbol and whether it occurs in a procedure refer- 
ence. (Reference: Meta-Symbol/LN, OPS Reference Man- 
ual, 90 09 52.) 



BASIC 

BASIC is a compiler and programming language based on 
Dartmouth BASIC. It is, by design, easy to teach, learn, 
and use. It allows individuals with little or no programming 
experience to create, debug, and execute programs via an 
on-line terminal. Such programs are usually small to medium 
size applications of a computational nature. 

BASIC is designed primarily for on-line program development 
and execution, or on-line development and batch execu- 
tion. In addition, programs may be developed and executed 
in batch mode. 



BASIC provides two user modes of operation. The editing 
mode is used for creating and modifying programs. The 
compilation/execution mode is used for running completed 
programs. This arrangement simplifies and speeds up the 
program development cycle. 



One of the many Meta-Symbol features is a highly flexible 
list definition and manipulation capability. In Meta- 
Symbol, lists and list elements may be conveniently rede- 
fined, thus changing the value of a given element. 

Another Meta-Symbol feature is the macro capability. 
Xerox uses the term "procedure" to emphasize the highly 
sophisticated and flexible nature of its macro capability. 
Procedures are assembly-time subroutines that provide the 
user with an extensive function capability. Procedure def- 
inition, references, and recursions may be nested up to 
32 levels. 

Meta-Symbol has an extensive set of operators to facilitate 
the use of logical and arithmetic expressions. These opera- 
tors facilitate the parametric coding capabilities available 
with Meta-Symbol (parametric programming allows for dy- 
namic specification of both "if" and "how" a given state- 
ment or set of statements is to be assembled). 

Meta-Symbol users are provided with an extensive set of 
directives. These directives, which are commands intrinsic 
to the assembly, fall into three classes: 

1. Directives that involve manipulation of symbols and 
are not conditionally executed. 

2. Directives that allow parametric programming. 

3. Directives that do not allow parametric programming. 

A number of intrinsic functions are also included in Meta- 
Symbol. These give the user the ability to obtain informa- 
tion on both the structure and content of an assembly time 
construct. For example, the user can acquire information 



Statements may be entered via a terminal and immediately 
executed. The principal benefit of direct execution is on- 
line development of programs and short simple computations. 
During execution, programs may be investigated for loop 
detection, snapshots of variables may be obtained, values 
of variables may be changed, flow of execution may be re- 
routed, and so on. This unique capability allows an on- 
line terminal to be used as a "super" desk calculator. 

At compile and execute time, the user may specify if an 
array dimension check is to be made. In the safe mode, 
statements are checked to verify that they do not reference 
an array beyond its dimensions. In the fast mode, this 
time consuming check is not made. Thus, the safe mode 
could be used during checkout, and the fast mode could be 
used to speed up execution when the program reaches the 
production stage. 

BASIC provides an image statement that uses a "picture" of 
the desired output format to perform editing. It also has 
TAB capability and a precision option to indicate the num- 
ber of significant digits (6 or 16) to be printed. 

An easy-to-use feature is provided to allow the user to read, 
write, and compare variable alphanumeric data. This is 
particularly important for conversational input processing. 

Chaining permits one BASIC program to call upon another 
for compilation and execution without user intervention. 
Thus, programs that would exceed user core space may be 
segmented, and overlay techniques may be employed via 
the chaining facility. (Reference: BASIC/Reference Man- 
ual, 90 15 46.) 
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FLAG 



8. Calling sequence for FORTRAN, Meta-Symbol, etc. 



FLAG (FORTRAN Load and Go) is an in-core FORTRAN 
compiler that is compatible with the FORTRAN IV-H class 
of compilers. It can be used in preference to the other 
FORTRAN compilers when users are in the debugging phase 
of program development. FLAG is a one-pass compiler and 
uses the Extended FORTRAN IV library. Included in the 
basic external functions are the Boolean functions IAND 
(AND), IEOR (exclusive OR), and IOR (OR), which give 
the FORTRAN user a bit manipulation capability. 

If several FLAG jobs are to be run sequentially, they may 
be run in a sub-job mode, thus saving processing time nor- 
mally needed for the Control Command Interpreter (CO) to 
interpret the associated control cards. In this mode, 
FLAG will successively compile and execute any number 
of separate programs, thereby reducing monitor overhead. 

The FLAG debug mode is a user-selected option that gener- 
ates extra instructions in the compiled program to enable 
the user, during program execution, to detect errors in pro- 
gram logic that might otherwise go undetected or cause un- 
explainable program failure. (Reference: FLAG/Reference 
Manual, 90 16 54.) 



9. Packed decimal as well as floating-point arithmetic 
formats. 

10. Data name series options for ADD, SUBTRACT, MUL- 
TIPLY, DIVIDE, and COMPUTE verbs. 

The system provides the user with a comprehensive set of 
aids to minimize the time required to print "bug-free" pro- 
grams in the form of listings. These listings include 

1. The source language input to the compiler with inter- 
spersed English language diagnostic messages. 

2. An optional listing of the relocatable binary output, 
printed in line number sequence identical to the source 
language listing. 

3. A cross-reference listing, indicating by line number 
where each data name or paragraph name is defined in 
the COBOL program and where each reference is 
located. 

In addition, at run time, the user may use TRACE and 
EXHIBIT to follow execution of the procedure division. 



ANS COBOL 

The Xerox ANS COBOL compiler offers the user a powerful 
and convenient programming language facility for the im- 
plementation of business or commerical applications. The 
language specifications fully conform to the proposed ANSI 
standard for the various functional processing modules. 
Only those language elements that cause ambiguities or are 
seldom used have been deleted. The compiler's design 
takes full advantage of the machine's unique hardware 
features, resulting in rapid compilation of source code, 
rapid execution of the resulting object code, and the gen- 
eration of compact programs. The result is a highly efficient 
programming system requiring a minimum amount of storage. 

Xerox ANS COBOL contains many facilities that are either 
not found in other systems or, if available, are provided 
only at greater cost in terms of equipment required. Some 
of the facilities that provide more flexibility and ease of 
use in program development include 

1. Implementation of table handling mode. 

2. Sort/merge linkage. 

3. Sequential access. 

4. Random access linkage. 

5. Segmentation. 

6. Report writer. 

7. Library utilization. 



The compiler is designed to take full advantage of high- 
speed, random access secondary storage (e.g., RAD stor- 
age). This feature means faster job execution because of 
minimized I/O delays, and smaller core memory require- 
ments because of rapid overlay service. (Reference: ANS 
COBOL/LN Reference Manual, 90 15 00.) 



APL 



APL is an acronym for A Programming Language, the lan- 
guage invented by Kenneth Iverson. It is an interpretive, 
problem-solving language. As an interpretive language, 
APL does not wait until a program is completed to compile 
it into object code and execute it; instead, APL interprets 
each line of input as it is entered to produce code that is 
immediately executed. As a problem-solving language, 
APL requires minimal computer programming knowledge; a 
problem is entered into the computer and an answer is re- 
ceived, all in the APL language. 

Because APL is powerful, concise, easy to learn, and easy 
to use, it is widely used by universities, engineers, and 
statisticians. It also has features that make it attractive 
for business applications where user interaction and rapid 
feedback are key issues. One of APL's major strengths is 
its ability to manipulate vectors and multidimensional arrays 
as easily as it does scalar values. For example, a matrix 
addition that might require a number of statements and 
several loops in other languages can be accomplished as 
A + B in APL. This type of simplification exemplifies APL's 
concise power. (Reference: APL/LN,OPS Reference Man- 
ual, 90 19 31.) 
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MANAGE (PROGRAM PRODUCT)' 



LINK 



Manage is a generalized file management system. It is 
designed to al low decision makers to make use of the computer 
to generate and update files, retrieve useful data, and gen- 
erate reports without having a knowledge of programming. 

Manage consists of four subprograms: Dictionary, Fileup, 
Retrieve, and Report. The Dictionary subprogram is a data 
file and is the central control element in the Manage sys- 
tem. It consists of definitions and control and formatting 
parameters that precisely describe the characteristics of a 
data file. The Fileup subprogram initially creates and then 
maintains a data file. The Retrieve subprogram extracts data 
from a data base file according to user-specified criteria. 
The Report subprogram automatically prepares printed reports 
from data extracted by the Manage retrieval program. (Ref- 
erence: Manage/Reference Manual, 90 16 10.) 



SIMULATION LANGUAGE (PROGRAM PRODUCT) 1 

The Simulation Language (SL-1) is a simplified, problem- 
oriented digital programming language designed specifically 
for digital or hybrid simulation. SL-1 is a superset of CSSL 
(Continuous System Simulation Language), the standard 
language specified by Simulation Councils, Inc., for 
simulation of continuous systems. It exceeds the cap- 
abilities of CSSL and other existing simulation languages 
by providing hybrid and real-time features, interactive 
debugging features, and a powerful set of conditional trans- 
lation features. 

SL-1 is primarily useful in solving differential equations, a 
fundamental procedure in the simulation of parallel, con- 
tinuous systems. To perform this function, SL-1 includes 
six integration methods and the control logic for their use. 
In hybrid operations, SL-1 automatically synchronizes the 
problem solution to real-time and provides for hybrid input 
and output. 

Because of the versatility of Xerox computing systems and 
the broad applicability of digital and hybrid simulation 
techniques, applications for SL-1 exist across the real-time 
spectrum. The library concept of SL-1 allows the user to 
expand upon the Xerox supplied macro set and facilitates the 
development of macro libraries oriented to any desired ap- 
plication. (Reference: SL-l/Reference Manual, 90 16 76.) 



EXECUTION CONTROL PROCESSORS 

Processors in this group control the execution of object pro- 
grams. Delta and COBOL On-Line Debugger can be used 
in on-line mode only. Load can be used in batch mode 
only. Link and FDP can be used in either batch or on- 
line mode. 



See "program product" in glossary. 



Link is a one-pass linking loader that constructs a single 
entity called a load module, which is an executable pro- 
gram formed from relocatable object modules (ROMs). Link 
is designed to make full use of mapping hardware. It is not 
an overlay loader. If the need for an overlay loader exists, 
the overlay loader (Load) must be called and the job must 
be entered in the batch stream. (Reference: CP-V/TS 
Reference Manual, 90 09 07. ) 



LOAD 

Load is a two-pass overlay loader. The first pass processes 

1. All relocatable object modules (ROMs). 

2. Protection types and sizes for control and dummy sec- 
tions of the ROMs. 

3. Expressions for definitions and references (primary, 
secondary, and forward references). 

The second pass forms the actual core image and its re- 
location dictionary. (Reference: CP-V/BP Reference Man- 
ual, 90 17 64.) 

DELTA 

Delta is designed to aid in the debugging of programs at 
the assembly-language or machine-language levels. It 
operates on object programs and tables of internal and glo- 
bal symbols used by the programs but does not require that 
the tables be at hand. With or without the symbol tables, 
Delta recognizes computer instruction mnemonic codes and 
can assemble machine-language programs on an instruction- 
by-instruction basis. The main purpose of Delta, however, 
is to facilitate the activities of debugging by 

1. Examining, inserting, and modifying such program 
elements as instructions, numeric values, and coded 
information (i.e., data in all its representations and 
formats). 

2. Controlling execution, including the insertion of break- 
points into a program and requests for breaks on 
changes in elements of data. 

3. Tracing execution by displaying information at desig- 
nated points in a program. 

4. Searching programs and data for specific elements and 
subelements. 

Although Delta is specifically tailored to machine language 
programs, it may be used to debug any program. Delta is 
designed and interfaced to the system in such a way that it 
may be called in to aid debugging at any time, even after 
a program has been loaded and execution has begun. (Ref- 
erence: CP-V/TS Reference Manual, 90 09 07.) 
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FORTRAN DEBUG PACKAGE 

The FORTRAN Debug Package (FDP) is made up of special 
library routines that are called by Xerox Extended FOR- 
TRAN IV object programs compiled in the debug mode. 
These routines interact with the program to detect, diag- 
nose, and in many cases, repair program errors. 

The debugger can be used in batch and on-line modes. An 
extensive set of debugging commands are available in both 
cases. In batch operation, the debugging commands are 
included in the source input and are used by the debugger 
during execution of the program. In on-line operations, 
the debugging commands are entered through the terminal 
keyboard when requested by the debugger. Such requests 
are made when execution starts, stops, or restarts. The de- 
bugger normally has control of such stops. 

In addition to the debugging commands, the debugger has 
a few automatic debugging features. One of these features 
is the automatic comparison of standard calling and receiv- 
ing sequence arguments for type compatibility. When appli- 
cable, the number of arguments in the standard calling se- 
quence is checked for equality with the receiving sequence. 
These calling and receiving arguments are also tested for 
protection conflicts. Another automatic feature is the test- 
ing of subprogram dummy storage instructions to determine if 
they violate the protection of the calling argument, (Ref- 
erence: FDP/Reference Manual, 90 16 77. ) 



COBOL ON-LINE DEBUGGER 

The COBOL On-line Debugger is designed to be used with 
Xerox ANS COBOL. The debugger is a special COBOL 
run-time library routine that is called by programs compiled 
in the TEST mode. This routine allows the programmer to 
monitor and control both the execution of his program and 
the contents of data-items during on-line execution. The 
debugger also allows the COBOL source program to be 
examined and modified. 

The debugger can only be used during on-line execution; 
however, programs that have been compiled for use with 
the debugger may be run in the batch mode. This is not 
recommended, though, because of the increased program 
size when the TEST mode is specified. (Reference: ANS 
COBOL/On-line Debugger Reference Manual, 90 30 60.) 



numbered, variable length records. This structure permits 
Edit to directly access each line or record of data. 

Edit functions are controlled through single line commands 
supplied by the user. The command language provides for 
insertion, deletion, reordering, and replacement of lines 
or groups of lines of text. It also provides for selective 
printing, renumbering records, and context editing opera- 
tions of matching, moving, and substituting line-by-line 
within a specified range of text lines. File maintenance 
commands are also provided to allow the user to build, copy, 
merge, and delete whole files. (Reference: CP-V/TS Ref- 
erence Manual, 90 09 07. ) 



PERIPHERAL CONVERSION LANGUAGE 

The Peripheral Conversion Language (PCL) is a utility sub- 
system designed for operation in the batch or on-line en- 
vironment. It provides for information movement among 
card devices, line printers, on-line terminals, magnetic 
tape devices, disk packs, and RAD storage. 

PCL is controlled by single-line commands Supplied through 
on-line terminal input or through command card input in the 
job stream. The command language provides for single or 
multiple file transfers with options for selecting, sequenc- 
ing, formatting, and converting data records. Additional 
file maintenance and utility commands are provided. (Ref- 
erences: CP-V/TS Reference Manual, 90 09 07 and CP-V/BP 
Reference Manual, 90 17 64. ) 



SYSGEN 

SYSGEN is made up of several processors. These proces- 
sors are used to generate a variety of CP-V systems that are 
tailored to the specific requirements of an installation. The 
SYSGEN processors are PASS2, LOCCT, PASS3, and DEF. 
PCL is used to select from various sources the relevant 
modules for system generation. PASS2 compiles the required 
dynamic tables for the resident monitor. LOCCT and PASS3 
file away and execute load card images to produce load 
modules for the monitor and its processors. DEF writes a 
monitor system tape that may be booted and used. (Refer- 
ence: CP-V/SM Reference Manual, 90 16 74.) 



SERVICE PROCESSORS 

The processors in this group perform general service func- 
tions required for running and using the CP-V system. 



EDIT 



The Edit processor is a line-at-a-time context editor desig- 
nated for on-line creation, modification, and handling of 
programs and other bodies of information. All Edit data is 
stored on disk storage in a keyed file structure of sequence 



DEFCOM 

DEFCOM makes the DEFs and their associated values in one 
load module available to another load module. It accom- 
plishes this by using a load module as input and by produc- 
ing another load module that contains only the DEFs and 
DEF values from the input module. The resultant load 
module of DEFs can then be combined with other load 
modules. DEFCOM is used extensively in constructing the 
monitor and the shared run-time libraries. (Reference: 
CP-V/BP Reference Manual, 90 16 64.) 
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SYMCON 



ELLA 



The Symbol Control Processor (SYMCON) provides a means 
of controlling external symbols in a load module and of 
building a global symbol table. Its primary function is to 
give the programmer a means of preventing double defini- 
tions of external symbols. It may also be used to reduce 
the number of external symbols. For example, if certain 
load modules cannot be combined because their control 
tables are too large, the tables may be reduced in size by 
deleting all but essential external symbols. (Reference: 
CP-V/BP Reference Manual, 90 17 64. ) 



The Error Log Listing program (ELLA) provides an efficient 
tool to list and sort the error data base which is automati- 
cally generated and updated by the CP-V system. (Refer- 
ence: Chapter 6. ) 



APPLICATION PROCESSORS 

The application processors are intended for use for specific 
types of applications. 



ANLZ 

ANLZ provides the system programmer with a menas of ex- 
amining and analyzing the contents of dumps taken during 
system recovery. It is called automatically by the Automa- 
tic Recovery Procedure and is executed as a ghost job. It 
may also be called by the operator to analyze tape dumps 
when recovery is not possible, or by an on-line user to 
examine crash dumps or the currently running monitor. 
(Reference: Chapter 4. ) 



BATCH 

The Batch processor is used to submit a file or a series of 
files to the batch queue for execution. Through Batch pro- 
cessor commands, the following capabilities are available: 

1. A file may be inserted into a file being submitted for 
execution, thus bringing together more than one file 
to create a single job. 

2. Selected strings and fields existing in files being sub- 
mitted for execution may be replaced by new strings 
and fields. 

3. The results of string and field replacements can be 
examined before the fob is submitted to the batch 
stream. 

4. Files to be submitted for execution may reside on tape 
or private disk pack. 

5. Jobs may be submitted to run in an account other than 
the account from which the job is submitted. 

The Batch processor may be called in either the on-line or 
the batch mode. (Reference: CP-V/TS Reference Man- 
ual, 90 09 07.) 



DRSP 

DRSP (Dynamic Replacement of Shared Processors) enables 
the system programmer to dynamically add, replace, or 
delete processors during normal system operation with other 
users in the system. (Reference: Chapter 7. ) 



SORT/MERGE 

The Xerox Sort/Merge processor provides the user with a 
fast, highly efficient method of sequencing a nonordered 
file. Sort may be called as a subroutine from within a user's 
program or as a batch processing job by control cards. It 
is designed to operate efficiently in a minimum hardware 
environment. Sorting can take place on from I to 16 keys 
and each individual key field may be sorted in ascending 
or descending sequence. The sorting technique used is 
that of replacement selection tournament and offers the 
user the flexibility of changing the blocking and logical 
record lengths in explicitly structured files to different 
values in the output file. 

The principal highlights of Sort are as follows: 

1. Sorting capability allows either magnetic tapes, disks, 
or both. 



2. Linkages allow execution of user's own code. 

3. Sorting on from 1 to 16 key fields in ascending or 
descending sequence is allowed. Keys may be al- 
phanumeric, binary, packed decimal, or zoned deci- 
mal data. 

4. Records may be fixed or variable length. 

5. Fixed length records may be blocked or unblocked. 

6. Disks may be used as file input or output devices, or 
as intermediate storage devices. 

7. Sort employs the read backward capability of the tape 
device to eliminate rewind time. 



8. User-specified character collating sequence may be 
used. 



9. Buffered input/output is used. 



(Reference: Sort-Merge/Reference Manual, 90 11 99.) 
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EDMS (PROGRAM PRODUCT) 1 " 

EDMS is a generalized data management system that enables 
the user to create an integrated data base. It is designed 
to be used with COBOL, FORTRAN, and Meta-Symbol pro- 
cessors. It simplifies programming by performing most of 
the I/O logic and data base management for the applica- 
tion programmer. 

The principal features of EDMS are as follows: 

• The user can describe data in various data structures. 
Using sets, any element can be related to any other 
element. The data structures include lists and hier- 
archies (trees). The two relationships can be combined 
to form extensive networks of data. 

• Access techniques include random, direct, indexed, 
and indirect (relative to another record). 

• An EDMS data base may consist of up to 64 monitor 
files. 

• Multiple secondary indexes can be defined by the user 
to allow records to be retrieved via any combination 
of secondary record keys. 

• Users may construct any number of logical files or data 
bases within an EDMS file. 

• Data is described separately from the user program to 
facilitate management of the data base. 

• Comprehensive security exists at all levels of a file. 

• Journalization provides an audit trail for backup and 
recovery. 

• A dynamic space inventory is maintained to facilitate 
rapid record storage and to optimize the use of avail- 
able storage space. 

• Detailed data description is provided for inclusion into 
the user's application program to reduce programming 
effort. 

• File I/O logic is performed for the user program 
including 

1. Logical or physical record deletion. 

2. Record retrieval on random or search basis. 

3. Record insertion or modification. 
(Reference: EDMS/Reference Manual, 90 30 12.) 



GPDS (PROGRAM PRODUCT) 1 

The General Purpose Discrete Simulator provides engineers 
and administrators, whose programming experience is mini- 
mal, with a system for experimenting with and evaluating 



system methods, processes, and designs. Providing a means 
for developing a broad range of simulation models, it allows 
organizing, modeling, and analyzing the structure of a sys- 
tem, observing the flow of traffic, etc. Potential applica- 
tions include 

e Advanced management planning. 

Analysis of inventory or financial systems. 

Studies of message switching and communications 
networks. 

Risk and capital investment studies. 

Evaluation and data processing systems. 

Job shop and queuing studies. 



Although GPDS is compatible with other simulator systems, 
It has a number of salient features not usually found in 
competitive versions. (Reference: GPDS/Reference Man- 
ual, 90 17 58.) 



CIRC (PROGRAM PRODUCT)* 

CIRC is a set of three computer programs for electronic cir- 
cuit analysis: CIRC-DC for dc circuit analysis, CIRC-AC 
for ac circuit analysis, and CIRC^TR for transient circuit 
analysis. The programs are designed for use by a circuit 
engineer, and require little or no knowledge of programming 
for execution. 



CIRC can be executed with three modes of operation pos- 
sible: conversational (on-line) mode, terminal batch entry 
mode, and batch processing mode. The system manager will 
determine which of these modes are available to the engi- 
neer, based on type of computer installation and other in- 
stallation decisions. 

• The on-line mode offers several advantages since it 
provides true conversational interaction between the 
user and computer. Following CIRC start-up procedures, 
CIRC requests a control message from the user. After 
the control message is input (e.g., iterate a cycle of 
calculations with changed parameters) the computer 
responds (via CIRC) with detailed requests for appli- 
cation data. These requests are sufficiently detailed to 
virtually eliminate misunderstandings by the engineer. 
This mode is highly useful in a highly interactive en- 
vironment that produces a low volume of output and 
requires limited CPU time. 

• The terminal batch entry mode allows efficient handling 
of high volume output and large CPU time requirements 
while preserving the advantages of the terminal as an 
input device. Two files are required, one containing 



See "program product" in glossary. 
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all CIRC input including a circuit description and 
control messages and the other directing the execution 
of CIRC. The job is entered from the terminal into the 
batch queue and treated like a batch job. 

The batch mode should generally be used for jobs in- 
volving large volumes of computations and outputs. It 
enables the user to concentrate on data preparation 
with virtually no involvement in programming consider- 
ations. The system manager can provide a set of 
start-up cards that never change, and these will con- 
stitute the entire interface between user and executive 
software. However, the batch mode offers less flexi- 
bility in experimenting with a circuit and slower 
turnaround time in obtaining answers. 



11. System Integrity. 

12. Initialization and Start-up. 

13. Operator Communications. 

14. Batch Debugging. 

15. Load-and-Link. 

16. System Debugging. 



(References: CIRC-AC/Reference Manual and User's Guide, 
90 16 98, CIRC -DC/Reference Manual and User's Guide, 
90 16 97, and CIRC-TR/Reference Manual and User's 
Guide, 90 17 86.) 



The basic control system is an I/O interrupt service and 
handling routine. It includes trap and interrupt handlers, 
routines that place requests for I/O in a queue, and basic 
device I/O handling routines. 



USER PROCESSORS 

Users may write their own processors and add them to 
CP-V or replace CP-V processors. The rules governing the 
creation and modification of processors are described in 
Chapter 7. 



MONITOR 

The monitor responds to the moment-by-moment require- 
ments of controlling machine operation, switching between 
programs requiring service, and providing services at the 
explicit request of the user's program. The monitor pro- 
grams that perform these functions are listed below. 

1. Basic Control. 

2. Scheduling and Swapping. 

3. Memory Management. 

4. File Management. 

5. Multibatch Job Scheduling. 

6. Resource Management. 

7. Job Step Control. 

8. Terminal ]/0 Handling. 

9. Symbionts. 

10. Cooperatives. 



The scheduling and swapping module makes the decision to 
swap, selects the users to swap in and out, sets up the I/O 
command chains for swap transfers, and selects the next user 
for execution. It also ensures that any associated, but not 
currently resident, shared processors are brought in with 
each user. Special algorithms control J/O scheduling and 
the balance of machine use between on-line and batch. 



The memory management module controls the use of core 
and disk storage. Specifically, it controls the allocation of 
physical core memory, maintains the map and access images 
for each user, services the "get" and "free" service calls 
for memory pages, and manages the swapping disk space. 



File management routines control the content and access to 
physical files of information. These routines perform such 
functions as indexing, blocking and deblocking, managing 
of pools of granules on RADs and disk packs, labeling, la- 
bel checking and positioning of magnetic tape, formatting 
for printer and card equipment, and controlling access to 
and simultaneous use of a hierarchy of files. 



The multibatch job scheduling routines select jobs to be run 
from the waiting input queue depending on priority and re- 
source and partition availability. 



Resource management facilities keep track of the number 
of resources of each kind (i.e., tape drives, disk spindles, 
core) that are in use. For a batch job, the multi-batch 
scheduler compares the resources required with the avail- 
able resources and does not start the job until sufficient 
resources are available. Once the job is started, the re- 
sources that are required by the job are reserved for the 
exclusive use of the job, thereby guaranteeing that they 
will be available for the duration of the job. 
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Job step control routines are entered between major segments 
of a job or an on-line session. They perform the monitor 
functions required between job steps such as 

1. Processing error exit and abort CALs. 

2. Handling monitor aborts. 

3. Processing interpretive exits to associated shared pro- 
cessors or to load program modules. 

4. Merging DCB assignments for execution. 

5. Checking user authorization for individual processors. 

6. Fetching program load modules into core. 



Terminal I/O handling routines perform read-write buffer- 
ing and external interrupt handling for I/O directed to user 
terminals. These routines also translate character codes, 
insert page headers and VFC control characters, simulate 
tabs, and perform other formatting tasks. 



Symbiont routines transfer data from the card reader to 
logical device streams on disk storage and from logical de- 
vice streams on disk storage to the card punch or line 
printer. 



Cooperative routines intercept read, print, or punch com- 
mands in user programs and transfer data from or to logical 
device streams residing on disk storage. The input coopera- 
tive simulates card reading from a logical device stream. 
The output cooperative builds a logical device stream using 
intercepted program output directed by the user program to 
a line printer or card punch. 



System integrity facilities provide error detection and re- 
covery capabilities. This includes security to user files and 
automatic high-speed restart in case of system failure. Suf- 
ficient information is recorded to isolate errors and failures 
caused by hardware or software. 



Initialization and start-up routines are stored on tape and 
are booted into core storage. After they are in core, they 
load the monitor root into core and turn control over to the 
root. The monitor root then completes the initialization 
of the monitor by starting and running the program called 
GHOST! which completes the patching of the system and 
the initialization of the swapping disk and hardware. 



Batch debugging routines provide batch programs with 
debugging capability through the use of procedure calls. 
Any batch program may take a snapshot dump of a specified 
segment of memory, either on an unconditional or a con- 
ditional basis. 



System debugging routines provide debugging services to 
system programmers. Three debugging routines are avail- 
able. They are 

1. Executive Delta: This is a stand-alone processor and 
is essentially the same as on-line Delta. Executive 
Delta is optionally loaded at boot time along with the 
root of the monitor and monitor system tables. 

2. Analyze: This program is intended for debugging CP-V 
crash dumps. To accomplish this, it performs two 
major functions. 

a. It summarizes the complete software environment 
at the time of the crash in a series of tables. 

b. It permits on-line interactions similar to Delta. 

3. Recover: This program provides the "bail-out" exit 
from the monitor. The error code that is transmitted 
to RECOVER defines the problem and the module that 
discovered the problem. 

Load-and-link routines give batch programs three types of 
loading and linking capability. Through the use of proce- 
dure calls, a batch program may 

1. Load an overlay segment into core storage. 

2. Store the calling program on disk storage, load the 
called program into core storage, and transfer control 
to the called program. 

3. Load a program into core storage, transfer control to 
the called program, and release the core area used by 
the calling program. 

CP-V has two FORTRAN libraries. One is a public library 
and the other is a system library. In the standard release of 
CP-V, the public library contains two sets of programs. 
One set (PI) contains a useful set of Extended FORTRAN IV 
run-time library routines, the other set (PO) contains PI and 
the FORTRAN Debug Package. These two libraries are so 
constructed that a single copy is shared among all concurrent 
users. The system library contains a collection of routines 
that are less frequently used than the public library routines. 
They are in library load module form and are loaded only 
with programs that reference them. 



Operator communication routines provide for communica- 
tion between the monitor and the operator. They transmit 
messages to the operator and process key-ins received from 
the operator. 



SCHEDULING AND MEMORY MANAGEMENT 

Scheduling and memory management routines control the 
overall operation of the system. Inputs to these routines, 
together with the current status of users as recorded by the 
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scheduler, are used to change the position of each user in 
the scheduling status queues. It is from these queues that 
selections are made for both swapping and execution. Swaps 
are set up by the selection of a high priority user that is to 
be brought into core and by pairing this user with one or 
more low priority users that are to be transferred to disk 
storage. Similarly, the highest priority user in core is 
selected for execution. 



SCHEDULER INPUTS 

System activities are reported by direct entry to the sched- 
uler, which makes changes to user status queues through a 
logical signaling table. The scheduler records inputs by 
changing the user status queues and other information asso- 
ciated with the user. In general, a table-driven technique 
is used. The received signal is on one coordinate and the 
current state of the user is on the other. The table entry 
thus defined names the routine to be executed in response 
to the given signal-state combination. Since the number 
of signals and states is large, the table technique aids in 
debugging by forcing complete specification of all the pos- 
sibilities. Inputs to the scheduler are listed in Table I. 
The scheduler also receives control at execution of each 
CAL issued by a user program that is requesting monitor 
service. These entries (Table 2), the special entries from 
the executive language processors, and entries from intern- 
ally reported events drive the scheduling of the system. 



Table 1. Event Inputs Received by Scheduler (cont. ) 



Table 1 


Event Inputs Received by Scheduler 


Event 


Meaning 


ErABRT 


Operator aborted user. 


E:AP 


Associate shared processor with user. 


E:ART 


Activate real-time user. Interrupt has 




occurred. 


E:CBA 


COC buffer available. 


E:CBK 


Break signal received. 


E:CBL 


Number of output characters > SLTB. 


E:CEC 


TEL request (©©, ©Y, or Y c ). 


E:CFB 


Cannot find COC buffer. 


E:CIC 


Terminal input message complete. 


E:CRD 


Read terminal command received. 


E.-CUB 


Number of output characters = SL.-UB. 


E:DPA 


RAD page available. 


E:ERR 


Operator errored user. 


E:IC 


I/O complete. 



Event 


Meaning 


E:IIP 


I/O started and now in progress. 


E:IP 


Request permission to start I/O. 


E:KO 


User removed from core. 


E:NC 


Cannot get requested core pages. 


E:ND 


Cannot get requested disk page. 


ErNOCR 


User allowed to open or close file. 


ErNSYMD 


No symbiont disk space. 


ErNSYMF 


No symbiont file entry. 


E:NQR 


Enqueue release —resource available. 


E:NQW 


Enqueue —wait for resource. 


E:OCR 


Request permission to open or close file. 


E:OFF 


User has hung up telephone. 


E:QA 


User queued for access (e. g. , for access 




to tape or disk pack). 


E:QE 


Quantum end. 


E:QFAC 


No granules available for use. 


E:QFI 


Real-time user. Queue for interrupt. 


E:QMF 


Queue for I/O master function count too 




high. 


E:SL 


Sleep time for user. 


E:SYMF 


Symbiont file now available. 


E:SYMD 


Symbiont disk space now available. 


E:UQA 


User dequeued for access (e.g., for ac- 




cess to tape or disk pack). 


E:UQFAC 


ALLOCAT has refreshed granule stacks. 


E:WU 


Wake-up time for user. 
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Table 2. Service Request Input to Monitor 



Source of Inputs 


Service Request Entries 


User program 


1. 


Terminal input/output request. 


(through monitor 






service calls) 


2. 


Input/output service calls for 
RAD, disk pack, or magnetic 
tape. 




3. 


Wait request. 




4. 


Program exit (complete). 




5. 


Core request (for common, 
dynamic, or specific pages). 




6. 


Real-time services. 




■7. 


Program overlay (load and 
link, load and transfer). 




8. 


Debug requests. 




9. 


Miscellaneous service requests. 


Executive 


1. 


Name of system programs to 


language 




be loaded and entered (im- 


processor 




plies deletion of any current 
program). 




2. 


Continuation signal. 




3. 


Special continuation address. 




4. 


Link load -and -go-exit. 



The second function the scheduler performs consists of 
selecting a user for execution according to the priority state 
queues and the rules for batch processing. The rule is 
simple: the highest priority user whose program and data 
are in core is selected. 



USER STATUS QUEUES 

Status queues form a single priority structure from which se- 
lections for swapping and execution are made. The status 
queues form an ordered list with one and only one entry for 
each user. The position in queue is an implied bid for 
the services of the computer. As events are signaled to the 
scheduler, individual users move up and down in the prior- 
ity structure. When they are at the high end, they have a 
high priority for swapping into core and for execution. When 
they are at the low end, they are prime candidates for re- 
moval to secondary storage. This latter feature — that of 
having a defined priority for removal of users to disk stor- 
age — is an important and often overlooked aid to efficient 
swap management. It avoids extraneous swaps by making 
an intelligent choice about outgoing as well as incoming 
users. 

In addition to these primary functions, user status queues 
have other functions such as 

1. Synchronizing the presence in core of the user program 
and data with the availability of I/O devices. 

2. Queuing user programs to be "awakened" at a preestab- 
lished time. 

3. Queuing requests for entry and use of processors. 

4. Managing core memory. 

5. Queuing requests for buffers either in core or on ; 
disk. 

6. Queuing requests for nonresident monitor services. 
A list of the status queues is given in Table 3. 



SCHEDULER OUTPUT 

The scheduling routine performs two major functions during 
the time it is in control of the computer. The first function 
consists of setting up swaps between main core memory and 
secondary disk storage in such a way that high priority users 
are brought into core to replace low priority users that are 
transferred to disk storage. The actual swap is controlled 
by an l/O handler according to specifications prepared by 
the scheduler. These specifications are prepared according 
to the priority state queues described in the next section. 
Given a suitably large ratio of available core to average 
user size (greater than 4), the scheduler can keep swaps 
and computing close to 100 percent overlapped. 



SCHEDULER OPERATION 

To select users for execution, the scheduler searches down 
a list of the status queues for the first user in core memory. 
The highest priority user. is served first. Interrupting users 
are served before those with an active input message (both 
of these take precedence over users with unblocked termi- 
ng I output), then come on-line compute-bound users and 
finally, compute-bound batch jobs. Note that users in 
lower states have no current requests for CPU resources. 
Note also that as each user is selected for execution, the 
status queue of the user is changed to CU. When the quan- 
tum is complete, the highest priority queue the user can 
enter is the compute queue. Users that enter any of the 
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Table 3. Scheduler Status Queues 



State 


Meaning 


SRT 


Real-time execute {0< priority < X'BF'). 


SCO 


Background execute (X'CO 1 < 
priority 5X^5'). 


SCI 


Background execute (priority = X'F6*). 


SC2 


Background execute (priority = X'F7'). 


SC3 


Background execute (priority = X'F8'). 


SC4 


Background execute (priority = X*F9'). 


SC5 


Background execute (priority = X'FA'). 


SC6 


Background execute (priority = X'FB'). 


SC7 


Background execute (priority = X'FO). 


SC8 


Background execute (priority = X'FD'). 


SC9 


Background execute (priority = X'FE 1 ). 


sao 


Background execute (priority = X'FF'). 


STOB 


Terminal output blocked in core. (More 
characters than the system limit are ready 
for typing. ) 


STOBO 


Terminal output blocked. Not in core. 


SIOW 


I/O wait. Users waiting for an I/O that is 




in progress to complete. 


SIOMF 


Users blocked because I/O master function 
count (number of I/O operations in progress) 
has reached the system limit. 


SW 


Users waiting for a specified "wake-up" 
time. 


SQA 


Users waiting for service by RBBAT, the 
symbiont ghost. 


SQR 


Users in core and blocked for dynamic re- 
source such as swapper page, COC buffer, 
symbiont disk page, symbiont table space, 
enqueued resource, service by ALLOCAT 
(for file granules), or file open or close. 


SQRO 


Same as SQR but not in core. 


STI 


Typing input and in core. 


STIO 


Typing input and not in core. 


SQFI 


Real-time user waiting for interrupt. 



three highest priority states receive rapid response but only 
for the first quanta of service. Thereafter, they share ser- 
vice with others in the compute queue. 

A similar selection procedure is used to set up users for 
swapping. First, the highest priority user in the execution 
queue who is not in core is selected and his size require- 
ment (including the requirement for shared processors not in 
core) is determined. Second, users are selected from the 
swapout queue until enough space is freed by these users 
and their shared processors to provide for the user selected 
for swap-in. If a single user in a state below SC10 (Table 3) 
can be found to swap out, then a single rather than a multi- 
ple swap is chosen. No swaps occur until a user that is not 
in core enters a high priority queue. 

Two lists resulting from this selection are presented to the 
swapper. One list contains the user (or users) to be swapped 
out and the other contains the user to be swapped in. This 
latter list also contains the shared processors that must 
accompany the user and the current free core page list. 
When the scheduler selects users for swapping, it picks a 
high priority user to load into core and the lowest priority 
user to remove from core. Priorities are arranged from high 
to low, in order of increasing expected time before the next 
activation. This ensures that the users that are least likely 
to be needed are swapped out first, while the users most 
likely to require execution are retained in core. The swap 
algorithm operates so that compute users remain in core and 
use all available compute time, while the interactive users 
are swapped through the third core slot whenever the fol- 
lowing three conditions exist: 

1. There is room in core for three user programs. 

2. Two users are computing steadily. 

3. Many other users are doing short interactive tasks. 



Table 4 shows the queue used for selection of users to be 
brought in for execution and the queue used for selection 
of users to be moved to disk. 



Note that the queues CU, IOW, QRO, TOBO, TIO do not 
appear in either list. Thus, the users in these states are not 
selected either for execution or for swapping. 

Two examples of typical interactive use are illustrative of 
the scheduling operation. 

The first example traces scheduling operations for a simple, 
short interactive user request. At the time the request is 
typed, the user is in the STI queue. His program, which 
has probably been swapped to disk storage, remains there 
until the COC routines receive an activation character. 
Receipt of this character is reported to the scheduler 
and causes a change in state of the user to the appro- 
priate executable state (SC0-SC10). The scheduler finds 
a high priority user not in core and initiates a swap to 



16 Monitor 



Table 4. Swap-In and Swap-Out Queues 



Swap-In 




(and Execution) 


Swap-Out 


Queue 


Queue 


SRT 


sw 


SCO 


STI 


SCI 


STOB 


SC2 


SQFI 


SC3 


SQA 


SC4 


SC10 


SC5 


SQR 


SC6 


SC9 


SC7 


SC8 


SC8 


SC7 


SC9 


SC6 


SC10 


SC5 




SC4 




SC3 




SC2 




SCI 




SCO 




SRT 



this typing time, the program is not required in core and 
the CPU resources can be given to other programs. 



remove a low priority user (if necessary) and to bring 
in the one just activated. On completion of the swap, 
the scheduler is again called and now finds a high priority 
user ready to run. The user's state is changed to CU, the 
program is entered, and the input command is examined by 
the reading program. The cycle in this example is com- 
pleted by preparation of a response line and a request to 
the monitor for more input which changes the user's state 
to TI again, making him a prime candidate for removal 
to disk. 



I/O SCHEDULING 

I/O scheduling is designed to provide good service to I/O- 
bound users while keeping the CPU busy with compute- 
bound users. The intent is to make the fullest possible 
utilization of both the CPU and the I/O devices. The 
manner in which this is accomplished is described below. 



A user that has been waiting for an I/O to complete (SIOW) 
is changed to an executable state at a priority slightly 
higher than a similar compute-bound user when the I/O 
completes. At that time, the execution scheduler inter- 
rupts the execution of the compute-bound user so that the 
I/O-bound user can execute. The I/O-bound user requires 
comparatively little CPU time before initiating another I/O 
request and returning to the SIOW state. The compute- 
bound user then resumes execution. 



It should be noted that the scheduler automatically adapts 
to jobs that alternate between bursts of computing and bursts 
of I/O. 



SWAP HARDWARE ORGANIZATION 

Users are removed from core to a dedicated area of disk 
storage (or to several disks in large configurations) when 
core is required for higher priority users. 



Bit tables are used to keep track of the availability of each 
sector on the disks. In these tables, a zero is used to indi- 
cate the sector is in use (usually assigned to a user) and a 
one is used to indicate the sector is available. Users are 
assigned a sufficient number of page-size sectors to accom- 
modate their current use. The assignment is done in such a 
way that command chaining of the I/O can order the sectors 
to be fetched for a single user with minimum latency. That 
is, each user's pages are spread evenly over the set of 
available sectors on the disk to which he is dedicated so 
that data will be transmitted in every disk sector passed 
over when the user is swapped. 



The second example illustrates an output-bound terminal 
program. This program moves through the state cycle STOB- 
SC-SCU as output is generated by the program. The COC 
routines signal when the output limit has been reached, 
thus causing the program to be delayed while output is 
transferred to the terminal. In a typical operation, four 
to six seconds of typing is readied in buffers each time the 
user program is brought into core and executed. During 



The records of disk sectors associated with each user are 
kept in the user's Job information table (JIT), which is kept 
on disk when the user is not in core. The disk location of 
the JIT and the user's disk address are kept in core by the 
scheduler. The disk layout is such that sufficient time is 
available after the user's JIT arrives from the disk for the 
system to set up the I/O commands for the remainder of 
the user. 
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The amount of disk storage assigned to swapping is a 
parameter of SYSGEN. The number of on-line users that 
the system can accommodate is limited by the size of disk 
space allocated for swapping and the total size of active 
on-line users. 



Due to the system configuration and SYSGEN, at most 
six sets of devices can be created: 



1. RAD all PFA (PFA RAD first). 



The allocation scheme for systems which have file space 
allocated on both RADs and disk packs is described in the 
following paragraphs. 



2. Pack all PFA (PFA pack first). 

3. All PER (PER first). 



For the sake of overall performance, the RAD is preferred 
for frequently accessed system information and temporary 
files used by the major processors. Special users who 
need high performance on special files may specify RAD 
preference. 



4. RAD PFA plus PER and/or PSA (PFA RAD second, 
PER second). 

5. Pack PFA plus PER and/or PSA (PFA pack second, 
PER third). 



All of the account directory and all files from :SYS are as- 
signed to the RAD. The first granule of each file directory 
is assigned to disk pack but any addition granules are as- 
signed to RAD. All star or id files and all scratch files 
(opened OUT or OUTIN with REL) prefer RAD. Random 
files with no user stated preference and all other files and 
their indexes prefer pack. These pack preferences may be 
overridden either by the operator keyin 'PREFER' for all 
files or by the user specification of NOSEP and DEVICE 
for individual files. 



Briefly, the effect of authorization and defaults upon the 
allocation is: If not enough space is available on the pre- 
ferred device, the other device will be used if space is 
available there. The exception to this is random files with 
user specified preference. In this case, if space is not 
available on the user specified device, the file is not al- 
located and an error is returned to the user. Also, within 
the authorized limits, temporary files may use only tempo- 
rary authorization and permanent files may use only perma- 
nent authorization. 



In general, the rule for authorization should be: A large 
amount of temporary RAD and disk pack space should be 
authorized for all users and the amount of permanent disk 
space should be individually authorized by need. Very few 
users should be authorized permanent RAD space. 



There are four in-core buffers for types of space to be al- 
located. Three are for granule allocated devices: 

1. RAD PFA (permanent file storage). 

2. Pack PFA (permanent file storage). 

3. PER (peripheral symbiont storage). 

The fourth is for cylinder requests. These buffers are used 
to satisfy requests for all purposes except directories, random 
files, and PSA (permanent system storage and swapping). 



6. PER plus PSA (PER fourth). 

Granules are selected for the in-core buffers from one of 
the six sets of devices starting each device at sector zero 
and allocating from all the devices within the set simul- 
taneously (i.e. , round-robin). The preference in choice 
of sets is noted above in parentheses. All devices of a set 
will be depleted before the next set is chosen. 



Cylinders for the in-core buffer are allocated starting at 
cylinder zero of the first (lowest DCT index) cylinder al- 
located device. Each device will be depleted before the 
next is used. 



Random files are allocated starting at the last sector of the 
last (highest DCT index) device of the proper type. The 
cylinder allocated devices are treated as one continuum 
of space for random files. They need not be contiguous in 
the DCT table and any file may cross a boundary (even a 
two cylinder boundary). Private random files are allocated 
in the same way. 



PROCESSOR MANAGEMENT 

CP-V processors are considered shared processors when they 
are written in such a way that they are pure procedure and 
are described as such when they are added to the system. 
(User-associated data areas are initialized at first entry.) 
A shared processor has the following special characteristics: 



1. Its name is known to TEL and it may be called by 
name. 

2. It has dedicated residency on swap storage established 
at system initialization or via DRSP. 

3. A single copy is shared by all requesting users. 
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MEMORY LAYOUT 

The system makes full use of address mapping hardware, 
access protection, and write locks in allocating available 
physical core pages to users. Physical core pages are allo- 
cated to users at their request. Use of the map obviates 
the need for program relocation or physical moves. Full 
protection is provided for one user from another. All pro- 
grams and the monitor itself are divided into procedure and 
data. The procedure area is protected by write-locks or 
access codes, or both, against inadvertent stores. 



The central features of the use of write-locks to protect 
master mode programs are as follows: 

1. The monitor operates with a key of 01 and may store in 

a. Its own data area (LOCK =00). 

b. Any batch, on-line or shared processor code 
(LOCK =01). 

It may not store in its own procedure (LOCK = 11). 

2. Keys of 10 and 11 are never used, nor is the lockof 10. 

3. Write-locks are initialized only once at system start-up 
and are not changed thereafter except when running 
under control of Executive Delta where they are used 
to enable data breakpoints. 

4. On the Xerox 560, write keys are four bits long and 
apply to the IOP memory writes as well as CPU write 
operations. To take advantage of this feature, the 
560 I/O system always uses a key of 1000 which does 
match any of the locks. This means that no I/O opera- 
tion can accidentally overwrite the monitor or its data 
since the IOPs can only write into memory with locks 
of zero (the user area). Also on the 560, certain mon- 
itor buffers which are part of the monitor data area 
(usually with lock 01) are grouped together and the 
pages containing those buffers are set to a lock of 0000. 
Except for this difference, the rest of the locks are 
exactly the same as for the Sigma computers. 



The access code on virtual memory pages controls references 
made by slave mode programs (user programs and shared pro- 
cessors). This cede is retained in the JIT of each user and is 
loaded into the hardware access protect registers (which are 
part of the virtual mapping hardware) when the user gains 
control. Write access to JIT and other job context areas is 
given to TEL, CCI, LOGON, and any installation-defined 
command processors. 



The layout of virtual memory that applies to user programs 
and ordinarily shared processors is shown in Figure 2. Al- 
location of the available area depends on the type of 
user that is running and the attributes of the load module 



to be executed. Allocation Type II is used when a core 
library or debugger is associated or when the load module 
to be executed has been built by Link. In all other cases, 
allocation of the available area is as shown in Type I for 
batch users, ghost ]obs, and on-line users executing in the 
extended memory mode. 



Core addresses shown are those appropriate for a typical 
system but more (or less) core may be established for the 
resident monitor at SYSGEN time depending on installation 
needs. More (or less) area may also be desirable for the 
library area and for the job context area to accommodate 
more buffers. These bounds may also be adjusted at SYSGEN 
time. The boundary at which the one-pass loader (Link) 
places the user program is also adjustable. 

Virtual pages not currently allocated to the user are mapped 
into a resident monitor page that is write-locked, (the ac- 
cess code is set to no access). Thus, slave mode programs 
are denied access through the access code, and attempts to 
store at these virtual addresses by a master mode program 
are protected by write locks. 

Typical layouts of physical memory are shown in Figure 3 
for Sigma systems and in Figure 4 for Xerox 560 systems. 
Although these are similar to the actual layout, they should 
not be assumed to be exact. 



SYSTEM INTEGRITY 

The monitor has a number of routines that have been in- 
cluded to guarantee system integrity. The objectives of 
these routines are, in order of importance, (1) to provide 
the highest possible security for user files even in the event 
of total system failure, (2) to provide automatic high-speed 
recovery in the event of a machine or software failure, and 
(3) to record sufficient information to isolate errors and 
failures caused by either hardware or software. 

The major features of the CP-V system integrity routines are 
as follows: 

1. Detection of malfunctions by hardware examination 
and software checks wherever the checks have been 
shown to enhance hardware error detection. Recovery 
from these malfunctions is through retries, operator as- 
sistance, etc. 

2. Logging of all malfunctions, including recovered errors 
and permanent failures. 

3. Protection from hardware failures. 

4. Use of on-line exercisers to provide for repair or ad- 
justment of peripherals without taking the CPU down. 

5. File backup and recovery facilities to minimize the 
probability of losing user files, and in case of file 
failure, to facilitate complete recovery of the file sys- 
tem with a minimum of loss. 
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Figure 2. Typical User Program — Virtual Memory Layout (not to scale) 
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Figure 3. Typical Memory Layout for Sigma Computers (not to scale) 
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Figure 4. Typical Memory Layout for the Xerox 560 (not to scale) 



6. Automatic recovery following a system failure with 
reasonable speed consistent with file security and the 
recording of information for later analysis. 

7. Facilities to provide for analysis of system crashes. In- 
formation includes simple classification of failures as 
well as full information for both customer engineers 
and system programmers. 

8. For the Xerox 560 — on-line interface for remote 
assistance. 



ERROR AND FAILURE LOGGING 

Malfunction messages are maintained in a special file by 
system integrity routines. Messages are placed in this file 
whenever malfunctions are detected by the various parts of 
the system. Hardware malfunctions that are recorded in- 
clude such things as tape errors, card reader errors, memory 
parity errors, and illegal instructions. Software ma I functions 
that are recorded include the failure of software checks 
on RAD or disk addresses contained in index blocks and 
improper linkage of linked file blocks. In addition, a 
software recovery from a seek failure is recorded in this 
file (as a 757F code). 



ERROR DETECTION AND RECOVERY 

An effective operating system must be able to detect and, 
whenever possible, to correct errors. It must also be cap- 
able of restarting the system if necessary. CP-V uses a 
combination of hardware and software checks to efficiently 
meet these goals. 

Hardware error protection features include memory protec- 
tion against accidental overwriting of monitor and user pro- 
grams, power fail-safe interrupts that ensure automatic 
restart in the event of power failure, memory parity check- 
ing, I/O read and write verification, and a watchdog timer 
to avoid instruction hangups. Detected errors are reported, 
logged, and if possible, recovered directly. Catastrophic 
failures cause an automatic system recovery if at all pos- 
sible. Those failures which can be isolated to a single user 
cause only that user to be aborted. Some hardware errors, 
such as loss of a memory power supply, lead to system 
shutdown. 



The error messages generated throughout the system (report- 
ing both hardware and software errors) are placed initially 
in in-core buffers and then are transferred to a special file 
(actually a linked list of granules). This transfer is initiated 
whenever an error count threshold, or time limit is reached. 
This special file is then transferred to an ordered keyed file 
(ERRFILE) by the standard system ghost processor ERR:FIL 
which is automatically awakened by the system. 



ERROR LOG LISTING 

This keyed file (ERRFILE) may be listed and sorted by the 
processor ELLA which allows the Customer Engineer to dis- 
play and search the error file for patterns of errors to aid in 
preventive maintenance for the system. 



Software consistency checks, some of which are performed 
optionally on the setting of a console sense switch, check 
the Integrity of the software at many critical locations in 
the system. These checks detect problems before they are 
allowed to go beyond a recoverable point. When an incon- 
sistency that is catastrophic to the system is detected, the 
current users are logged off and all open files are closed. 
The system is then automatically rebooted for the fastest 
possible restart. 



ON-LINE DIAGNOSTICS AND EXERCISERS 

On-line diagnostics and exercisers may be called when 
there is a specific failure detected by the hardware or soft- 
ware, or when a failure is projected through analysis of the 
error log by the Customer Engineer. These programs may 
also be called by the Customer Engineer when needed for 
the test or adjustment of the card reader, card punch, line 
printer, magnetic tape, or other devices. 



Monitor 
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REMOTE DIAGNOSTIC ASSISTANCE 

On the Xerox 560, on-line diagnostics and certain on-line 
debugging processors (ANLZ, Delta, and ELLA) may be 
utilized via the Remote Assist Station (RAS) interface. 

After control is obtained from the local operator, customer 
engineers and/or diagnostic programmers at remote locations 
may access the system via this interface without interfering 
with the on-line COC users and without using any of the 
normal communication equipment. By evaluating the sys- 
tem under normal operating conditions, many software errors 
and hardware malfunctions may be detected and eliminated 
expeditiously with a minimum of computer down time. 



FILE MAINTENANCE 

CP-V provides a variety of processors designed to maintain 
a reliable backup of the file data base. These processors are 
summarized in the CP-V/SM Reference Manual, 90 16 74, 
and are described in detail in the CP-V/OPS Reference 
Manual, 90 16 75. The processors provide the ability to 
save and restore large volumes of files very quickly, to save 
and restore entire private and public disk devices at device 
speed, to handle user initiated backup of files, to restore 
the allocation tables for public disks after a system crash, 
to restore the allocation tables for a private disk pack after 
a crash which affected the pack, and to restore granule ac- 
count information in the :USERS file. 



AUTOMATIC RECOVERY AFTER SYSTEM FAILURE 

The CP-V monitor performs consistency checks on the 
results of hardware operations, checks intermediate results 
of operating system software functions, performs checks and 
balances at appropriate interfaces between the operating 
system's modules, and monitors itself for unexpected trap 
conditions caused by the hardware or operating system soft- 
ware. A software check code is assigned to each type 
of failure that the monitor may detect. 

Some of these software check failures result in a momentary 
delay in service to all but the current user for whom the 
operating system is performing a service. In such case, 
the current user's job step is aborted, core is dumped to a 
file for later analysis and display, and normal operating 
then continues. The remaining software check failures are 
handled by the system's recovery routine. 

The recovery routine performs the following functions: 

1. Displays cause of failure. 

2. Takes a full core dump for later analysis. 

3. Closes all open files with default options. 

4. Packages or releases all partial symbiont files. 



5. Closes common TP journal if transaction processing is 
being used. 

6. Saves in-core transaction processing files. 

7. Packages error log. 

8. Informs users of interruption. 

9. Saves time, data, error log pointers, accounting infor- 
mation, symbiont file directory, public disk granule 
usage map, and executive communication. 

10. Restarts system and restores items saved above. 

When functions cannot be performed, they are noted on the 
operator's console. If the function is considered minor, re- 
covery continues. If it is connected with file operations, 
the file identification is noted and recovery proceeds. 



The recovery routine described above occurs automatically 
with a minimum delay (a few seconds) in system availability. 
Operator initiation of this recovery function is also allowed, 
providing for the event that the system fails by not respon- 
ing to any operator key-in or user service request. 



When the recovery routine executes, it is independent of 
all monitor services and functions and requires only that a 
small recovery driver be intact in memory. This driver 
reads the main recovery module into memory from the system 
swap device, overlaying the pure procedure portion of 
CP-V. Certain monitor system tables are also required in- 
tact for successful recovery. These tables are verified 
before proceeding. If the recovery process cannot be com- 
pleted, the operator is instructed to initialize the system 
from the master system tape and restore files and backup 
tapes. 



CRASH ANALYSIS 

In the event of a recovery or single user abort, one of the 
recovery functions is to dump the contents of core memory 
into a special file in the :SYS account. This information is 
saved for later analysis by a system programmer using a 
special debugging program, ANLZ. 



The ANLZ program may be called by the operator or system 
programmers to run as a privileged ghost, on-line, or batch 
job. The ANLZ program is also called automatically 
as a privileged ghost job by the recovery routine as one 
of the first jobs following a recovery or the first job fol- 
lowing a single user abort. In any mode, ANLZ is command 
driven (except in the ghost mode following a recovery). 
It responds to commands that selectively display monitor 
tables, examine memory, and compare the dump with 
the running monitor. (Reference: Chapter 4.) 
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3. BOOTSTRAP AND PATCHING OPERATIONS 



SYSTEM TAPE FORMAT 

A CP-V system tape contains the following elements; 

1. Bootstrap loader. 

2. Root for an absolute monitor. 

3. General information record concerning this system 
tape. 

4. Other monitor segments (XDELTA, ALLOCAT, GHOST1, 
FIX). 

5. Monitor overlay segments. 

6. RECOVER. 

7. Tape label information. 

8. Files for all system load mod u I es and other needed files. 

9. Patches and GENMD commands. 

The general arrangement of the information on a master sys- 
tem tape is shown in Figure 5. 



b. A groupof GENMD commands and GENMD patches 
to the processors contained on the tape. 

5. A !EOD command (the final command of the patch 
deck). 

In addition, there are two types of cards that may appear 
anywhere within the patch deck (including the GENMD 
portion). These two types are the conditional patch control 
command and the comment card. 

No patch, command, or comment may contain more than 
72 characters of information. 

When the patch deck is read, it is retained by the system in 
a file called PATCH in the :SYS account. This file can be 
examined using the PCL processor. It may also be assigned 
to M: PATCH and DEFed onto the PO tape. 

The function and format of Delta format patches, symbol def- 
inition patches, reconfiguration and partitioning commands, 
GENDCB commands, GENMD commands, GENMD patches, 
conditional patch control commands, and comment cards 
are described in the paragraphs that follow. 



PATCH DECK STRUCTURE 

Patch decks have the following structure: 

1. The following two types of patches: 

a. Delta format patches for the monitor root and its 
overlays. 

b. Symbol definition patches. 

The monitor root patches can appear anywhere within 
the patch deck. The overlay patches must be in the 
same order as the system tape structure. Symbol defini- 
tions must precede the patches in which the symbol is 
used. 

2. Boot-time reconfiguration and partitioning commands. 
These are optional, but if they are used, they must pre- 
cede the first overlay patch. 

3. A card that contains an asterisk in column one. This 
card terminates the monitor patches and boot-time re- 
configuration and partitioning commands. 

4. The following two types of patches (which may appear 
in any order): 

a. A GENDCB command to assign the account, a 
password, serial number, and type of tape drive 
for the boot tape. 



DELTA FORMAT PATCHES 

Delta format patches are used to patch various segments of 
the monitor. The format of a Delta format patch is: 

[segname]/loc/value[(old value)]/comment 



wh« 



segname is the name of the segment to be patched. 

The current segnames and the order in which they 
must be patched are shown in Figure 6. 

If a segname is present, the loc field must represent 
a location in the corresponding segment or the loc 
field (and value field) must be null. The latter 
type of patch would have the format. 

segname// (the third slash is unnecessary) 

and must be the first patch with its particular seg- 
name. (An example of this form of patch is given 
in the "Conditional Patch Control Commands' 
section below.) 



Example 



OPEN// START THE OPEN PATCHES 
OPEN/OPNH+.52/B PATCH/ 
/PATCH/LW,13 TABLES+.74/ 
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Note: 



Record sizes The tape bootstrap is 22 words long. Patch records are 80 words long. All other records 

are 512 words long. The figure indicates groups of such physical records. 

Head Head portion of load module. 

Data Protection type portion of load module. 

DCBs Protection type 2 portion of load module. 

Procedure Protection type 1 portion of load module. 

OVERLAY. M:MON overlays (shared processor type) as described in M:SPROCS module (e.g., OPEN, 

1 CLOSE, KEYIN, DEBUG, LDLNK, MULOV, LTAPE, MISOV, OPENTP, STEPOVR, RMAOV, 

RTNRRT, ENQ). 

OVERLAY Last M:MON overlay as described in the MrSPROCS module, 

n 

Patches Patches are included on the tape where shown if they exist in the file assigned to the 

M:PATCH DCB when DEF creates the system tape. The first group of M:MON root patches 
follows the Exec Delta data records. Any others are placed among segment patches accord- 
ing to their order in the patch file. The last record of each group of patches on the tape is 
the first patch for the next set of segment patches. The second through the last patch for a 
segment follow the segment to which they will be applied. GENMD patches follow the last 
of any patches following the RECOVER patches. 



Figure 5. Format of Master System Tape 
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C P 


- V 


SYSTEM GENERATED ON: 


12:00 AUG 


16, '74 


VERSION NO. 


IS : COO 


PATCH SEGMENT NAMES: 




(ROOT) 


ALLOCATO 


(DATA) 


ALLOC ATI 


(PROC) 


GH0ST10 


(DATA) 


GHOST 12 


(DCBS) 


GHOST11 


(PROC) 


FIXO 


(DATA) 


FIX2 


(DCBS) 


FIX1 


(PROC) 


CLOSE 


(DATA) 


DEBUG 


(DATA) 


ENQ 


(DATA) 


KEY IN 


(DATA) 


LDLNK 


(DATA) 


LTAPE 


(DATA) 


MISOV 


(DATA) 


MULOV 


(DATA) 


OPEN 


(DATA) 


OPENTP 


(DATA) 


RMAOV 


(DATA) 


RTNRRT 


(DATA) 


STEPOVR 


(DATA) 


TPOV1 


(DATA) 


TPOV2 


(DATA) 


UMOV 


(DATA) 


RECOVER 


(DATA) 



Figure 6. Segment Patching Order 

If no segname is present, any location between 
10*16 and FFF0] o maybe patched. Such patches 
may appear anywhere within the patch deck. 

loc is a Delta format symbolic location, possibly 

with offsets. 

value is the Delta format value to be inserted at 

loc. 

old value is the Delta format value of the previous 

contents of loc. 

Example: 

/I0RT+.F8/PSM,9 TSTACK(PSM,6 TSTACK)/ FIX SIDR #6646 

If a patch command is in error (e.g., has an illegal char- 
acter, an incorrect old value, a value occupying more than 
one word, or an invalid loc value), it will be typed on the 
OC device. The operator must determine what was wrong 
and correct the problem. 

If the error is apparent from examination of the patch, it 
can be corrected and the boot process restarted. Ifdesired, 
the system may be examined with Executive Delta, which 
is now in control and requesting commands at the operator's 
console. The patch in error may be corrected from the 
operator's console using Delta by entering the patch 



correction mode by keying— i0(use right bracket (]©) on 
the Xerox 560) and then the correct patch in the form given 
above. After receiving the correct patch, the system re- 
sumes reading patches. 



PATCH DECK SYMBOL TABLES 

The Delta format symbolic values that are recognized in 
patches are assembled by the system tape definition proces- 
sor, DEF, from the REF/DEF stacks of the patchable modules 
using these items: 

1. All DSECT names. 

2. All DEFs ending in a colon (the colon is removed in the 
patch deck symbol table). 

3. The first UDEF after each CSECT unless a colon DEF 
intervened. 

4. Patch segnames. 

For M.-MON only, all LDEFs are also included. The sym- 
bols obtained from M:MON and XDELTA are available to 
XDELTA at any time. Those from other modules are avail- 
able only while that module is being patched. DEF lists 
the symbols that are included as the tables are created. 

In addition, two special symbols are available during the 
patching process. 

The first is the symbol @ whose value is equal to the next 
available location in the patch area of the monitor. That 
is, it is initially equal to the monitor symbol, MPATCH, and 
its value is incremented by one each time a patch is encoun- 
tered whose loc field is equal to the current value of @. 
The use of the special symbol @ frees the user from having 
to allocate space in the PATCH area of the monitor since 
Executive Delta will automatically relocate the patch area. 

Example: 

The following two patch decks are equivalent: 



/IORT+.F8/B PATCH/ 
/IORT+.FE/B PATCH+l/ 
/PATCH/ LI, 3 12/ 
/.+1/CB.3 5/ 
/.+1/BNE $+2/ 
/.+1/B IORT+.F9/ 
/.+1/LI.3 0/ 
/.+1/B I0RT+.F9/ 



/IORT+.F8/B @/ 
/IORT+.FE/B @+l/ 
/@/LI,3 12/ 
/<a/CB,3 5/ 
/@/BNE $+2/ 
/@/B I0RT+.F9/ 
/@/LI,3 0/ 
/@/B I0RT+.F9/ 



The second special symbol is @@ and is used when an even 
address in MPATCH is required. The only restriction on this 
special symbol is that @@ cannot be referenced while patch- 
ing @ (e.g., /@/@@/). The results are unpredictable. 
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Example: 

/MM+.64/LPSD.8 @@/ 

/@a/MM+. 65+4**28/ 

/@/. 17000000/ 

New symbols may be added to the symbol table by including 
symbol definition patches in the patch deck. Symbol def- 
inition patches must have the format 

# SYMBOL = value 

where 

SYMBOL is any Delta format symbol. (The symbol 
can be no longer than eight characters.) 

value is any evaluatable expression terminated by 

a blank. 

Example: 

#GRUNCH=.D87 

/GRUNCH/B GRUNCH+.20/ 

/.+1/B (?/ 

/@/LW,3 TABLE S+3/ 

#JK=<a 

/@/CI,3 10/ 

/@/B GRUNCH+.50/ 



/55+.1E8/B JK/ 

In the above example, the patch at 55+. 1E8 branches to the 
instruction CI, 3 10. 



RECONFIGURATION AND PARTITIONING COMMANDS 



Three of these commands (:TYPE, : PART, and : REMOVE) 
contain the following parameter as part of the command 
format: 

value (sometimes referred to as value, and value.) 

The description of this parameter is quite detailed. To 
avoid repeating the description several times, it will be 
given here and references will be made back to this section 
in the command descriptions. 

The format of value is dependent on the CPU being used. 

For Sigma 6/7/9 systems, value must be in the format 

ndd 

where 

n represents a controller address and is specified as 

a letter. See Table B-2 in Appendix B. 

dd specifies the device number. See Table B-3 in 

Appendix B. 

For Xerox 560 systems, value may take one of two formats. 
The first format is 



ndd 



n represents a cluster number and a unit number. 

See Table B-4 in Appendix B. 

dd specifies the device number. See Table B-3 in 
Appendix B. 

The second format consists of four hexadecimal digits which 
represent a hardware address in the format 



00 


c 


u 


dd 


fl 1 


i sU 


5 6 7 


6 * i& III 12 li U 15 



where 

c specifies the cluster number. 

u specifies the unit number. 

dd specifies the device number. 



These commands provide a means of reconfiguring the system 
and partitioning devices and/or controllers at boot-time. 
All of the commands begin with a colon (:) and must end 
with a period or a trailing blank by at least column 72. 
The commands may be specified in any order with the ex- 
ception of :END which must appear last (if it is used). 

If no reconfiguration and partitioning commands are speci- 
fied, the system responds as if the :GO command had been 
specified. 



!G0 This command specifies that the configuration speci- 
fied on the system tape is to be used as is. The format of 
the command is 

:GO 

If :GO is specified, :TYPE and :REMOVE commands are not 
meaningful and the following message is output on the LL 
device: 



ALL : TYPE/:REMOVE COMMANDS IGNORED 
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If no reconfiguration and partitioning commands are speci- 
fied, the system responds as if the :GO command had been 
specified. 



:SAVE This command specifies that all device addresses 

not changed by :TYPE commands are to remain as is, except 
according to restrictions listed in the following description. 
The format of the command is 

:SAVE 

When the :SAVE command is specified, the following mes- 
sage is output on the LL device: 



**KEEP ALL DEV. ADDR. AS IS EXCEPT FOR :TYPE/ 
rREMOVE CHANGES 



When the :SAVE command is used, only those device ad- 
dresses which are different on the target machine from that 
of the SYSGENed system tape need be changed by the :TYPE 
command. All others remain as SYSGENed except when a 
:TYPE command redefines one or more device addresses for 
a specific device type. In this case, every device address 
of that device type must be defined by :TYPE commands 
whether or not the device address needs to be changed or 
the undefined ones will be removed from the system. The 
rREMOVE command may also be used to remove SYSGENed 
devices. 

When rSAVE is not specified, all device addresses must be 
specified by :TYPE commands. Any SYSGENed devices 
for which addresses are not defined by :TYPE commands are 
removed from the system configuration (and cannot be re- 
turned to the system configuration without rebooting). 



".TYPE The :TYPE command defines a device type, its 
model number, and its new device address or addessses. The 
format of the command for single access device definitions 
is 



alternate path address. When a device address 
change is required for a specific device type, all 
addresses must be specified even if no change is 
necessary, or those not specified for the device 
type will be removed from the system. 

The model number is verified as a legitimate model number 
by searching the MrMODNUM table. (See the SYSCON 
chapter in the CP-V/SM Reference Manual, 90 16 74.) 
When found, its corresponding controller model number is 
obtained from the MrMODNUM table. The device/controller 
model numbers are then used to check if this combination is 
the same as that which was originally SYSGENed for the 
given device. If not the same, all similar device/controller 
model number combinations in M:MODNUM are used for this 
validation. As an example, if MrMODNUM contains the 
following entriesr 



Device Model 


Controller Model 


Number 


Number 


7120 


7120 


7120 


7121 


7121 


7121 


7121 


7120 



and the SYSGENed combination is 



7120 



7121 



then the command rTYPE CR7121, ... . will cause the fol- 
lowing device/controller combinations to be checked with 
the indicated resultsr 



7121/7120 
7120/7120 
7121/7121 
7120/7121 



not valid 
not valid 
not valid 
valid 



:TYPE device, va I ue[, value!. . . 
and the format for dual access device definitions is 



rTYPE device, (value., value )[, (value., value-)]. ... 



/here 



device is a six character field. The first two char- 

acters specify the device type (e.g., CR) and the 
last four characters specify the device model num- 
ber in hexadecimal. 

value specifies the device address in the format de- 
scribed at the beginning of this section. The num- 
ber of addresses depends upon the number of devices 
of that device type which are on the target machine 
or which need address changes (when rSAVE is 
used). For dual access devices, value] specifies 
the primary path address and value2 specifies the 



: REMOVE This command removes a device or controller 

from the system. The removed device or controller cannot 
be returned to the system without rebooting. (Although 
public disk packs are not partitionable, they can be re- 
moved from the system.) The format of the command is 



:REMOVE { 
L 



value 1 

CONT, value] 



value specifies the address of the device or con- 
troller to be removed in the format described at 
the beginning of this section. 

CONT specifies that a controller is to be removed. 
When a controller is removed, all devices on that 
controller are also removed. 
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In the following example, four disk packs were SYSGENed 
and the target system is to have only two disk packs, one 
public and one private. 

:TYPE DP7242,BF0,BF1,BF2 

: REMOVE BF1 



SYSGENed 
Disk Packs 



Result of Result of 

:TYPE Command : REMOVE Command 



AFO - public BFO - public 

AFT -public BF1 - public 

AF2 - private BF2 - private 

AF3 - private removed 



BFO - public 
removed 
BF2 - private 
removed 



:PART The :PART command specifies a device or con- 
troller that is to be partitioned from the system. The device 
or controller is partitioned as if it had been partitioned by 
the SYSCON processer and can be returned to the system 
via SYSCON without re-booting the system. (Refer to the 
SYSCON processor description in the CP-V/SM Reference 
Manual, 90 16 74.) This is useful when a system is being 
booted and a partitionable device which was SYSGENed to 
be part of the system is currently unavailable. The format 
of the :PART command is 



:PART 



[value 1 

CONT, value] 



wfl€ 



value specifies the address of fhedevice or control- 
ler to be removed in the format described at the 
beginning of this section. 

CONT specifies that a controller is to be parti- 
tioned. When a controller is partitioned, all de- 
vices on that controller are also partitioned. 

A device partition request causes all devices which have 
identical device addresses to be paritioned. 



:END The :END command defines the end of the set of 

reconfiguration and partitioning commands. The command 
is optional because the occurrence of either the first nonroot 
patch or an asterisk (*) command would also indicate the 
end of reconfiguration and partitioning commands. 

The format of the command is 

:END 

When the end of reconfiguration and partitioning commands 
is encountered, all :TYPE command definitions are processed 
first, then all rREMOVE requests, and finally all :PART 
requests. 



RECONFIGURATION AND PARTITIONING EXAMPLE 

In the following example, a CP-V system was SYSGENed 
for four different hardware configurations. These config- 
urations are referred to as the 560X, 7T,7D, and 7E. A set 
of reconfiguration and partitioning commands was generated 
for each machine with the set of commands for each machine 
being bounded by a conditional patch control command. 
The four sets of reconfiguration and partitioning commands 
exist in the patch deck. The one set that is to be used for 
a particular boot is selected by a set of conditional patch 
control commands such as the following: 

# 560X = 

#7T=0 

#7D = 1 

# 7E=0 

The above commands indicate that the 7D machine is to be 
booted. Figure 7 lists the entire set of devices that were 
SYSGENed for this example. Figure 8 lists the set of recon- 
figuration and partitioning commands which were ignored 
because they were for machines not being booted. Figure 9 
lists the set of reconfiguration and partitioning commands 
which were used in the boot process because the 7D was 
selected. Figure 10 lists the set of devices for the 7D con- 
figuration. This information is listed on the line printer 
during a boot, but not necessarily in the order shown in the 
Figures. 



Example: 

A system was SYSGENed to have four 9-track tape drives 
but two are down for maintenance when the system is booted. 

:TYPE 9T7322,A80,A81,A82,A83 

:PART A82 

:PART A83 



RECONFIGURATION AND PARTITIONING MESSAGES 

Table 5 lists the messages that may be output when recon- 
figuration and partitioning commands are being processed. 

When an error is encountered, the error message is preceded 
by a message containing a dollar sign ($) beneath the char- 
acter position in the command at which the error was found. 
Processing of the command in error is discontinued. 
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Figure 7. Device Resource Configuration from SYSGEN 
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Figure 8. Reconfiguration and Partitioning Commands that were Ignored 
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Figure 9. Reconfiguration and Partitioning Commands that were Used 



*#*««««•«»**•****•««*#**«•«•«•«•«*«««**•««•**•**#«*••*•««**•*«*•«*••«*«*•«*«*•*«*• 




D E V 


ICE R 


E 


seu 


R 


c e c e 


N F I 


Q 


U R A 


T I 6 N 


DEV-TYP J 


DEVOID t 


DEV.AOOR 


J 


DCT.I 


1 


PUB/PR IV 


I TYPE 


: 


RT8T 


1 GENERAL INF8RMATI8N 


TY7012 


tyaci 


OOOl 




01 






TY 






N8T-PARTITI8NABLE 


CR7140 


CRA03 


0003 




02 






CR 






N8»PART»DEV JSYM 


CP7160 


CPAO* 


000* 




03 






CP 






SYMBI8NT 


LP7445 


LPA02 


0002 




04 






LP 






N8-PART-DEV 1SYM 


DC7212 


DCBFO 


01F0 




06 






DC 






N8T»PARTITI8NABLE 


DC7232 


DCCFO 


02F0 




08 












N8T«PARTITI8NABLE 


9T7322 


9TA80 


0080 




OA 






9T 




02 


N8-PART-C8NT 


9T7322 


9TA81 


0081 




OB 












NB-PART-C8NT 


DP7242 


DPD80 


0380 




10 




PUB 


DP 




00 


N8T-PARTITI8NABLE 


XP1200 


XPCOD 


020D 




IF 






XP 






N8«PART»C8NT ISYM 


ME7611 


MEA05 


0005 




20 






ME 






N8T-PARTITI8NABLE 


####*###*##♦###########«####•*##•♦##»####•*###»#•••»•#*#•#»•*##*##»»#»##»#*•••»**» 



Figure 10. Device Resource Configuration for the Booted System 



Table 5. Reconfiguration and Partitioning Messages 



Message 


Description 


ALL :TYPE/ : REMOVE COMMANDS IGNORED 
**device, value CANNOT BE ADDED TO SYSTEM 

CANNOT PARTITION, CONT. ndd ALREADY 
PARTITIONED 


A :GO command has been specified. :TYPE and :REMOVE 
commands are not meaningful. 

As the result of the :TYPE command, the SYSGENed system and 
target machine device/controller model number definitions are 
not equivalent. This message ispreceded bya message containing 
a dollar sign ($) under the device type and also under the first 
device address for single access or the alternate device address 
for dual access devices. 

device - device type and model number 

value - device address (in the format described at the be- 
ginning of this section) 

This message can also appear when there are more :TYPE defini- 
tions for the device type than allowed for in the SYSGENed system. 

The controller specified on a :PART command has already been 
partitioned. 
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Table 5. Reconfiguration and Partitioning Messages (cont.) 



Message 


Description 


CANNOT PARTITION, CONT.'ndd NON- 


The controller specified on a :PART command is notpartitionable. 


PARTITIONABLE 


(it is a controller for a Teletype, a RAD, or a COC, or it was 




defined at SYSGEN to be a non-partitionable controller.) 


CANNOT PARTITION, CONT. ndd NOT 


The controller specified on a :PART command either does not 


PRESENT 


exist or was removed in the reconfiguration process. 


CANNOT PARTITION, CONT. ndd NOT 


A disk pack controller was specified on a :PART command and 


PRIVATE PACK 


one or more of its associated disk pack spindles is public. Public 




disk pack spindles cannot be paritioned. 


CANNOT PARTITION, DEV. ndd ALREADY 


The device specified on a :PART command has already been 


PARTITIONED 


partitioned. 


CANNOT PARTITION, DEV. ndd NON- 


The device specified on a :PART command is not partitionable. 


PARTITIONABLE 


(It is either a Teletype, a RAD, or a COC, or it was defined 




at SYSGEN to be a non-partitionable device.) 


CANNOT PARTITION, DEV. ndd NOT PRESENT 


The device specified on a :PART command either doesn't exist 




or was removed in the reconfiguration. 


CANNOT PARTITION, DEV. ndd NOT PRIVATE 


Public disk pack spindles cannot be partitioned. 


PACK 




CANNOT REMOVE, CONT. ndd NOT PRESENT 


The controller specified on a : REMOVE command either does not 




exist or was previously removed in the reconfiguration process. 


CANNOT REMOVE, DEV. ndd NOT PRESENT 


The device specified on a : REMOVE command either does not 




exist or Was previously removed in the reconfiguration process. 


CONT. ndd PARTITIONED 


The specified controller has been successfully partitioned. 


CONTINUATION ILLEGAL 


Continuation commands (i.e., commands ended by a semicolon) 




are not allowed. 


DEV. ndd PARTITIONED 


The specified device has been successfully partitioned. 


DUAL ACCESS DEFINED ILLEGAL ndd , ndd. 


On a :TYPE command, the primary address and the alternate 


address on a dual access device are equivalent. 


DUAL/SINGLE ACCESS MIXTURE 


A :TYPE command specifies both single access and dual access 




device addresses; or the device type is for a single access device 




and the address is for a dual access device, (or vice versa). 


INVALID TERMINATOR 


A bad or unknown terminator terminates a field or option. Valid 




control command terminators are NEW LINE; period, carriage 




return, trailing blank, and end of control command image. 


**KEEP ALL DEV. ADDR. AS IS EXCEPT FOR 


A :SAVE command has been encountered. 


:TYPE/ : REMOVE CHANGES 
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Table 5. Reconfiguration and Partitioning Messages (cont.) 



Message 



Description 



NO RECONFIGURATION PERFORMED DUAL 
ACCESS DEFINITION CONFLICTS 

(ndd 1 [,ndd 2 ]),(nclcl 3 [,nclcl 4 ]) 



'"NO SPACE LEFT FOR CONFIG. INFO 



**PACK yyndd PARTITIONED, DIAL ndd 
NOT AVAILABLE 

**TAPE yyndd PARTITIONED, DIAL ndd 
NOT AVAILABLE 

UNKNOWN COMMAND, FIELD, OR VALUE 



The :GO command was specified, or no : commands were 
specified, or a :END command was specified by itself. A 
device address conflict has occurred as the result of :TYPE 
commands. Either a single access device address is the same as 
a primary or alternate address on a dual access device, or the 
primary address is the same as the alternate address on a dual 
access device. The ndds indicate the addresses involved. This 
message will appear twice for each conflict encountered (be- 
cause each :TYPE definition is compared with every other 
:TYPE definition). 

Too many :TYPE,:REMOVE, and :PART command definitions 
have been encountered. The total size of the internal buffer 
which retains reconfiguration and partitioning command is 
512 words. Each :PART and :REMOVE command requires one 
word, each :TYPE command for single access controllers requires 
two words, and each :TYPE command fur dual access requires 
three words. Additionally, the buffer contains one control 
word. The buffer is needed to retain all control command in- 
formation until every command has been processed. Actual 
processing of the commands takes place when the :END com- 
mand, the first nonroot patch, or an asterisk command is en- 
countered. 

The device specified on a :PART command is a disk pack spindle. 



The device specified on a :PART command is a tape drive. 



An unknown command, an invalid name, or a value field which 
contains too many characters, is not hexadecimal, or is not in 
the correct format for the particular machine was encountered. 
This message also appears for each reconfiguration and partition- 
ing command encountered after reconfiguration and partitioning 
processing has ended. It also appears when a :GO, :REMOVE, 
or :TYPE command is encountered after a :GO command has 
been processed and when a :SAVE command is encountered after 
a previous :SAVE command was processed. 



1GENDCB COMMAND 

This command defines the system DCB associated with tape 
input during PASSO. This command is required only if the 
files are on a different tape than the boot tape or if they 
occupy more than one reel. If the command is not present 
in the patch deck, PASSO reads the account and serial num- 
ber from the tape and performs an automatic premount of 
the tape. No operator intervention is required. 

The format of the GEN DCB command is: 

rGENDCB (M:BI,account[, password]; 

:, (INSN,value[, value]. . .), device) 



M:BI specifies that tape input is to be through the 
M:BIDCB. No other DCB is valid for this command. 



account specifies an account identifier (up to eight 
eight alphanumeric characters) associated with the 
labeled tape to be read during PASSO. 

password is the password associated with the labeled 

tape to be read during PASSO. The password (if 
any) must correspond to that specified when the 
tape was created, and may be up to eight alpha- 
numeric characters in length. 

INSN, value, . . . specifies the serial number(s) (up 

to four alphanumeric characters in length) of the 
tape(s) to be read by PASSO. No more than three 
reels may be specified. The first reel specified 
must contain the first file to be read, and may be 
different from the reel used to boot the monitor. 

device specifies a tape-type device code (e.g., 
9T, 71). 
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Example: 

rGENDCB (M:BI,ACCT1, PASS1,; 

:(INSN,001,002),9T) 

Any number of GENDCB commands may appear in the patch 
deck. Only the last will be applied. If it is defective, 
files will be copied from the boot tape. 

Any errors in the command are indicated by the message 

***GENDCB ERROR 

on the OC and LL devices. 

GENMD COMMANDS 

The GENMD commands are used in conjunction with the 
GENMD patches described below. The three GENMD com- 
mands are GENMD, LIST, and DELETE. 



GENMD This command indicates which file is to be 

patched next. A GENMD command must precede the set of 
patches for each file to be patched. Any number of sets of 
patches to the same file may be present, provided each is 
preceded by a GENMD command. The format of the com- 
mand is 

GENMD filename 

LIST This command lists the patches currently in the file 
being patched and has the format: 



segname is assumed. If not present and no 
segname was specified previously, the root seg- 
name is assumed. 

loc specifies the location to be patched and has the 

format[name] [±hex value]. The hexadecimal value 
is added to or subtracted from the absolute address 
of name. A maximum of eight characters may be 
used for the hexadecimal value. The name need 
not be defined in any particular overlay since all 
the stacks are searched. If more than one overlay 
defines the same name, the first is used. 

value specifies the value to be inserted at loc. If 
more than one value is specified, they will be in- 
serted at successive locations. Each value must 
have the format 

hex value[±name[±hame]. . .] 

The absolute address of the names are added to 
or subtracted from the hexadecimal value. A 
maximum of eight characters may be used for the 
hexadecimal value. The name need not be defined 
in any particular overlay since all the stacks are 
searched. If more than one overlay defines the 
same name, the first is used. 

A GENMD command may be continued by terminating the 
first line with a semicolon (;). The semicolon must not di- 
vide a name or a hexadecimal string and is not permitted 
where a blank is required. The continuation line must be- 
gin with a colon (:) if the continued line began with 
: GENMD. Otherwise, the continuation line begins with 
the next character of the command. 



LIST 



DELETE When a file is patched, a record is kept of the 
list of patches to the file within the file itself. The DELETE 
command removes this list of patches from the file (but does 
not remove the affect of the patches on the file). The com- 
mand may be used to prevent files from growing too large if 
they are not restored when applying a new patch deck. The 
format of the command is 

DELETE 



GENMD PATCHES 

GENMD patches are used to modify nonresident elements of 
the system. 

GENMD patches have the format: 

:GENMD 



[segname], 



[,segname] 



loc, value[,value]. . . [. comment] 



segname specifies the overlay segment name to be 
patched. If not present, the most recently specified 



GENMD ERROR MESSAGES 

Table 6 lists the error messages that may be output when 
GENMD commands and patches are being processed. 



CONDITIONAL PATCH CONTROL COMMANDS 

A conditional patch control command specifies whether the 
patches that follow are to be used as patches or are to be 
effectively ignored. The conditional patch control com- 
mand controls the SKIP flag. When the SKIP flag is set, 
all subsequent patches are effectively ignored until the 
SKIP flag is reset. The conditional patch control command 
can appear any number of times and anywhere within the 
patch deck (including the GENMD portion). The command 
has the format: 

* [value] 

where value is any well-formed, but not necessarily evalu- 
atable, expression terminated by a blank. The value expres- 
sion may contain an undefined symbol. 
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Table 6. GENMD Error Messages 



Message 


Description 


BAD LMN - 0000 


The file is not a load module. 


BAD LMN - xxxx 


An error occurred when accessing the load module. The code and 




subcode are indicated by xxxx. 


BAD SEG 


A segname is not in the TREE. 


DLM AT xx 


The delimiter in column xx is not what it should be. 


**nn GENMD ERRORS DETECTED 


This message is output on the OC and LL devices at the conclusion of the 




GENMD patching process and indicates how many errors occurred. 


HEX AT xx 


The hexadecimal number ending in column xx is null, too large, or not 




hexadecimal. 


LOC AT xx 


The location ending in column xx or whose value ends in column xx is 




not contained in the segment. 


NAME AT xx 


The name ending in column xx is null or is not in the load module's 




stacks. 


NO FILE NAMED 


A 'GENMD filename' command has not yet been encountered or has no 




filename on it. 


TOO BIG 


Not enough core is available. It may be possible to do the patch if all 




names are converted to absolute hexadecimal values, since the stacks 




are read only if a name is used. 



If value contains an undefined symbol, is negative, or is 
zero, the SKIP flag is set. While the SKIP flag is set, only 
the segname field of a patch is examined to determine when 
the current segment's patches end. If value is absent or 
greater than zero, the SKIP flag is reset and normal patch- 
ing resumes. 

The SKIP flag is also changed when a Delta format patch 
that does not have a ioc and value field is encountered 
(i.e., segname//). In this case, it is set if the segname is 
undefined and it is reset otherwise. 

Examples: 

1. The following patches will be included only if the sys- 
tem was generated for a large Sigma 9 or a large 
Xerox 560. 

#:BIG 

/SWAPPER+.C5/B @/ 

/@/Ll,5 0/ 

/@/SLS,7 LI/ 

/@/B SWAPPER+.C6/ 

# 



2. The following patches will be included only if the 
ENQ/DEQ feature was included in the system: 

ENQ// 

ENQ/ENQO+.266/B @(CW,13 ENQP+.1F4)/ 

/@/LB,15 ENQP+.1F4/ 

/@/CB,15 13/ 

/@/B ENQCH-.256/ 

OPEN// 

COMMENT CARDS 

Comment cards may appear anywhere within the patch deck. 
In the portion of the deck that contains Delta format patches 
and symbol definition patches, the comment card must con- 
tain a Mess than 1 character (<) in column one. In the 
GENDCB and GENMD portion of the deck, comment cards 
must contain one of the following in column one: 
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PATCH FILE CREATION 

All patches read during the startup of the system (except 
GENDCB commands) are copied to the file PATCH in the 
system account. Those that were read while the skip flag 
was set appear with the word SKIP in columns 77-80. The 
resulting file may be used as input to DEF to create a sys- 
tem tape with the complete, current patch deck on it. 



SEQUENCE OF OPERATIONS 

The master system tape is loaded into the machine by use of 
the standard load procedure described in the CP-V/OPS 
Reference Manual, 90 16 75. The hardware bootstrap loads 
and enters the tape boot at the beginning of the system tape. 
This tape boot, in turn, loads the monitor root and the fol- 
lowing functions are then performed. 

If the system was generated with the BIG option on the 
:MON card and is not being booted on a Sigma 9 or Xerox 
560, the following message is output to the operator's con- 
sole and the bootstrap operation is terminated. 



After the OC address has been validated, the following 
message is output to the operator: 



SYSTEM REQUIRES SIG9 OR X560 



The operator's console (OC) device address is validated. 
If the actual OC device address is different than that of 
the SYSGENed address, the system will halt (wait). The 
operator should enter the appropriate OC address into 
register 0. 

To enter the OC address on a Sigma machine: 

1. Put the machine in IDLE. 

2. Set the SELECT ADDRESS switches on the control panel 
to 0. 

3. Enter the appropriate device address into the SELECTed 
ADDRESS. 

4. Set the COMPUTE switch to the RUN position. 

To enter the OC address on the Xerox 560: 

1. Enter CONTROL P. 

2. Enter 0/ (which displays the contents of register 0). 

3. Enter the new device address followed by the letter M. 

4. Enter an X. (This will cause the 560 to resume pro- 
cessing.) 



ENTER ANY OF: 


I 


= TTY I/O 


P 


= LP OUTPUT 


F 


= TAPE FILES 


T 


= TAPE PATCHES 


C 


= CARD PATCHES 


D 


= XDELTA 



The operator must respond within 10 seconds by typing one 
or more of the characters above followed by new line or by 
entering new line alone. If new line alone or nothing is 
entered, T is assumed by default. If any characters other 
than those listed above are entered, they are ignored. 

The letters have the following meanings: 

I specifies that the operator wants to read and re- 

spond to the normal OC messages during the boot. 
Otherwise, default responses are assumed up to 
the date/time request (see below) and normal 
output is suppressed. (Error messages will still 
be output. ) 

P causes output to the LL device to occur. Other- 

wise, the printer is not used. 

F causes PASSO's tape copy operation to occur. 

Otherwise, a boot-under-the-files occurs. 

T define that the patch deck(s) are to come from 

and tape or cards respectively. Either, neither, or 
C both may be specified. If both are specified, 
cards will be read first for root patches and last 
for overlay patches and GENMD commands. 
Card patches meant to repatch tape root patches 
should therefore be placed aftera nonroot patch. 
Patches of the format segname// should be used 
in both patch decks to prevent the switching of 
devices from splitting up a logical patch. 

D causes Executive Delta to be retained after the 
boot for debugging purposes. 

N is meaningful only by itself and means "none of 
the above". 

If I was specified and if the system includes the real-time 
option, the system then issues the following message. 



RESDF SIZE IN PAGES? 



The message requests the operator to input the number of 
pages to be dedicated resident foreground pages. Any dec- 
imal value from to 128 may be entered. If NEW LINE 
alone is entered, the SYSGEN-defined default for number 
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of dedicated resident foreground pages will be used. In 
any case, the pages start at physical address 64K. 

After PASSO has executed, GHOST 1 requests the current 
date and time key-ins with the following messages: 



DATE (MM/DD/YY) 



TIME (HH:MM) = 



The operator must respond by typing the appropriate quan- 
tity in the indicated format, terminating the response as 
usual with ©, ©, or©. 

If the system is being loaded on a machine for which it was 
not SYSGENed, one of the following messages will be dis- 
played on the OC device and the bootstrap operation will 
be terminated. 



In response to each of these messages the operator must type 
two or three characters. If two characters are typed, they 
must be 'SA' and indicate no change for this device. If 
three characters are typed, they must be the channel and 
device designation codes (ndd) defining the address of the 
indicated device (see Appendix B, Tables B-2 and B-3). 

If the DC or swapper assignment is incorrect, one of the 
following five messages will be displayed. Three of the 
messages request a new swapper device address. 



NO RESPONSE FOR SWAPPER yyndd 
DCndd => DC 



(The device address Is unrecognizable by the hardware. ) 



DISC PACK BAD yyndd 
DCndd => DC 



SYSTEM NOT SYSGENED FOR SIGMA 6 



SYSTEM NOT SYSGENED FOR SIGMA 9 



SYSTEM NOT SYSGENED FOR XEROX 560 



If the system and target machines match and if I was speci- 
fied the following message is displayed: 



C/LL/DC ASSIGN OK (YES/NO) 



If the operator's response is YES or ©, it is assumed that 
the device addresses for the control device, listing log, 
and system device are not to be changed from those estab- 
lished when the monitor was defined. If the response is 
NO, then the following messages will be output to rede- 
fine these device addresses. 



(The disk pack spindle is not initialized or cannot be ac- 
cessed due to I/O transmission errors.) 



SWAPPER NOT 
DCndd => DC 



7212 
7232 
72DP 



(The RAD indicated by 7212 or 7232 or disk pack indicated 
by 72DP was expected as the swap device. ) 



SWAPPER WRITE PROTECTED yyndd 



(The swapper device is write protected. If a write protect 
violation is encountered during the reading and patching 
of the monitor overlays, the above message is output and 
the system stops. However, if this occurs during swapper 
initialization, then a new swapper device is requested as 
for the above messages. ) 



PSA TRACK FLAWED 



CRndd => CR 




LPndd =£• LP 




DCndd => DC 



where each ndd is the current device identification and as 
many DC messages are output as there are swap devices. 



(The swapper disk pack contains flaws. The boot process 
terminates.) 

Before completing any of the above responses with a ©or 
©, the operator may cancel the response by striking the © 
key. Following this, or if a completed response is in error, 
the message 



9 9 



will be output and the key-in request will be repeated. 
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If no characters are typed within 10 seconds, a © response 
is assumed. 

After all necessary responses have been received, the boot 
subroutine reads the system information record from tape 
and writes it on the LL and OC devices if Pand I are speci- 
fied, respectively. 

The following sense switch information is then listed on the 
OC device if I was specified. 



SET SENSE SWITCHES AND TYPE N/L 
SSW1 =>CHECKWRITE DISK WRITES 
SSW2 =>NO AUTOMATIC LOGON/LOGOFF 
SSW3 =>OPERATOR RECOVERY ON DISK BOOT 
SSW4 =>SYSTEM SECURITY CHECKING 



The system will continue when a NEW LINE or any other 
character is entered. 

Next, the reconfiguration and partitioning commands (if 
any exist) are read and processed. A summary of the 
system's device will be output on the LL device (even if 
no :TYPE commands are encountered). Permanently down 
devices are not listed. 

Next, the monitor patches are read and processed for the 
patching of the overlays, ALLOCAT, GHOST1, and 
RECOVER. (If the RECNFIG boot-time processor needs to 
be patched, XDELTA performs the patching as it does for 
the monitor root. However, these patches must precede 
the reconfiguration and partitioning commands in the patch 
deck. ) 

After the nonroot patches have begun, reconfiguration and 
partitioning commands are illegal. If any such commands 
appear in the deck, the following message is displayed on 
the OC device (and also on the LL device if P was speci- 
fied) and the bootstrap continues. 



':' COMMAND NOT IN PATCH DECK PROPERLY 



This message is displayed only one time, even if additional 
reconfiguration and partitioning commands are encountered. 
It then copies the overlays, etc., to the swapping device, 
communicating the sizes and disk addresses to the resident 
root of the absolute monitor. Control then passes to another 
boot subroutine at WRTROOT. This second boot subroutine 
causes the monitor root to be copied to the disk, preceded 
by a disk bootstrap. At this point, the resident monitor is 
operational but the system has not yet been established on 
the resident swapping device. The GHOST1 processor 
performs this function. 

If P was specified, GHOST1 determines whether any 
devices or controllers are partitioned. If none are parti- 
tioned, the following message is displayed on the LL device: 



*** NOTHING PARTITIONED 



However, if devices and/or controllers are partitioned, 
the following message is displayed on the LL device: 



***** ITEMS PARTITIONED ***** 



followed by messages identifying each device or controller 
which is partitioned. The messages have the following 
formats: 



DEV yyndd PARTITIONED 



(for devices) 



CONT yyndd PARTITIONED 



(for controllers) 

When all partitioned items have been identified, the 
following message concludes the list: 



END OF PARTITIONED ITEMS 



When P was not specified or when GHOST1 has completed 
the above listing, GHOST 1 starts the symbiont ghost, Fix 
ghost, ERR:FIL ghost, and fill ghost, and then exits. 



BOOTING FROM DISK 

Once the operating system has been bootstrapped from tape, 
it may thereafter be brought into core from the disk by 
means of the load procedure described in the CP-V/OPS 
Reference Manual, 90 16 75. 

The hardware boot routine loads and transfers control to the 
disk boot which then loads the monitor root into core. The 
system requests the date and time and then asks 



DO YOU WANT DELTA (Y/N)? 



to determine whether the system debugger's memory should 
be released. 

The following message is then output to the operator's 
console: 



DO YOU WANT HGP RECONSTRUCTION (Y/N)? 



A response of Y causes an HGP reconstruction of the public 
file system to be performed. If no response is received 
within one minute, N is assumed. 
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Partitioning information is displayed as described previously, 
and the system ghost jobs (Fill, ERR:FIL, and Fix) are 
started. Normal operation may then be resumed. 



BOOTSTRAP I/O ERROR RECOVERY 

I/O error recovery during bootstrap is provided for the card 
reader, line printer, magnetic tape, and disk. However, 
error recovery is not possible until the tape boot and mon- 
itor root have been read from tape. The following error 
messages may appear on the OC device: 



xx INOPERATIVE 



xx ERROR. TIO value TDV value 



xx MANUAL MODE 



CHECKWR1TE ERROR 



place the CPU into IDLE, STEP, and then RUN state. The 
I/O will then be retried. If the third message above oc- 
curs, I/O will continue when the condition is corrected. 
When an error occurs for a magnetic tape or disk opera- 
tion, the operation is retried ten times before an error 
message is output. If the fourth message above occurs, 
the wait state is entered. To continue, the operator must 
place the CPU into IDLE, STEP, and then RUN state. 
This message will appear if the checkwrite on disk fails. 
The checkwrite will be executed only if hardware sense 
switch 1 is set. 



PASSO PROCESSOR 

The PASSO processor performs various system initialization 
functions and is entered automatically whenever a CP-V 
tape is booted. 

PASSO reads a tape specified by the user (via the GENDCB 
command) which contains the nonresident elements of the 
system (i.e., CCI, processors, libraries, etc.). (This is nor- 
mally the labeled portion of the tape used to bootstrap the 
absolute monitor.) PASSO allows the user to modify these 
elements via the GENMD portion of the deck. 



wher 



value 



is MT, CR, DC, or LP. 

indicates the TIO or TDV results. 



When either of the first two messages above occurs, the 
wait state is entered. To continue, the operator must 



PASSO MESSAGES 

The messages in Table 7 may be output by the PASSO 
program on the LL device. PASSO continues its normal 
operation. 



Table 7. PASSO Messages 



Message 


Description 


***CANNOT BOOT LMN 


A load module cannot be read from the bootstrap tape because 
core is not large enough. PASSO outputs the filename in error 
and continues to the next file, thus ignoring the file in error. 


I/O ERR/ABN nn,xxxING FILE ffffffff ON dddd 


An I/O error or abnormal condition has occurred on tape or 
disk. 

nn is the error or abnormal code. 

xxxx is READ, WRITE, OPEN, or CLOSE. 

ffffffff is the current filename. 

dddd is TAPE or DISC. 

PASSO continues after this message. 
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4. MONITOR DUMP ANALYSIS PROGRAM 



INTRODUCTION 

The monitor dump analysis program ANLZ (Analyse) is 
designed to aid in the debugging of CP-V crash dumps. 
ANLZ operates in the ghost, on-line, and batch modes. 
It accepts as input any tape or disk dump produced by the 
recovery procedure and any tape dump produced by exe- 
cutive Delta. If a tape is input, the ANLZ user must sup- 
ply the tape type in response to the message 



ENTER TAPE TYPE: 7T, 9T, BT, ETC... 



Tape input results in the creation of a disk file (CP5DUMP); 
subsequent tape inputs replace the contents of this file. 



GHOST MODE 

ANLZ is called automatically by the recovery procedure, 
and functions as a ghost job to interpret and summarize crit- 
ical monitor tables and to dump the monitor's dynamic data 
area. When ANLZ is initiated after a system crash, it 
neither looks for nor accepts any commands, operating en- 
tirely on default options. It assumes an INPUT command 
option of LAST; if unable to open the last MONDMP file, 
it then assumes an INPUT command of TAPE. (Refer to the 
description of the INPUT command in the following text.) 
When Analyze is run in this manner, the output is an ab- 
breviated form of the output produced by the ALL display 
command. 

ANLZ is also automatically initiated after a single user 
abort. In this case, it functions just as though it had been 
initiated as a ghost job via an operator key-in. (This is 
described below. ) 

| ANLZ may be called as a ghost job by the operator to 
examine the tape produced during an irrecoverable crash. 
The operator key- in used for this purpose is 

GJ OB ANLZ 

I ANLZ then asks the operator for a command: 



ANLZ: ENTER COMMAND, N/L SAYS TO DO ALL 



The operator may respond with one of the following 
commands: 

NO - just exit. 

TA - read a recovery-built tape. 

ME - run interactively from the operator's console. 



CP - read the CP5DUMP file. 

1-7 - read the indicated MONDMP file. 

? - list the ANLZ commands on the line printer. 

N/L (new line alone) - do default ghost run. 

In the interactive ghost mode, a key-in of 

INT, id 

will cause termination of the current ANLZ operation and 
a prompt for input, (id specifies the ANLZ user's number. ) 

BATCH AND ON-LINE MODES 

Any batch or on-line user may call ANLZ by specifying 
the name of the program. For on-line users, this program 
name is entered in response to a TEL prompt for com- 
mands, as follows: 

IANLZ © 



Any user, in batch or in on-line mode, must have the proper 
privilege level (80 or better) to examine the monitor. If 
he does not, ANLZ outputs the following message 



xx PRIVILEGE LEVEL NOT HIGH ENOUGH 



where xx is the user's current privilege level. (Response 
messages are output on the line printer for a batch user. ) 

When accessed on-line, as an interactive ghost, or as a 
batch job, ANLZ is completely command-driven. It re- 
sponds to commands that selectively display monitor tables, 
examine memory, and compare the dump with the running 
monitor. 

An on-line user may terminate a display by depressing the 
BREAK key. 

COMMANDS 



When ANLZ is first entered, it responds 



ANALYZE HERE 



and, if in on-line mode, it requests entry of an input com- 
mand with the prompt character 
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All commands, options, and output are identical for batch, 
interactive ghost, and on-line modes. 



INPUT COMMAND 

INPUT The INPUT command directs ANLZ to input 

from a particular disk or tape file, or to open a file. The 
format of the command is 

INJPUfJoption 

where option may be any one of the options shown in 
Table 8. 

After reading a tape or disk file as directed by the INPUT 
command, ANLZ informs the user of the size of the file 
with the following message: 



THE LAST PHYSICAL PAGE IN THE FILE IS xx 



If in on-line mode, it then prompts (<)for the next command. 



Table 8. INPUT Command Options 



Option 


Meaning 


TA[PE] 


Directs ANLZ to read a tape created 
by the recovery process and to write it 
into the file CP5DUMP which is then 
used for input. 


CP[5DUMP] 


Directs ANLZ to open the CP5DUMP 
for input. 


LA[ST] 


Directs ANLZ to open the last file 
formed by the recovery procedure for 
input. (ANLZ must look at the run- 
ning monitor to obtain this information.) 


number 


Directs ANLZ to open a crash file 
formed by recovery. Recovery file 
names are of the form 

MONDMP(number) 

where number is the number of the dump 
file (1 for the first dump since a "cold" 
start, 2 for the second, and so on). 



DISPLAY COMMANDS 

Three display commands may be used to output information 
from crash dumps. They are 

DISPLAY 

RUN 

ALL 



DISPLAY The DISPLAY command outputs information 

existing at the time of the crash. The format of the com- 
mand is 

Dl[SPLAY]option 

where option specifies the information to be displayed 
(Table 9). 



RUN the RUN command outputs various linked lists of 

the monitor by running through the list and displaying each 
entry. The format of the RUN command is 

RU[N] option 

where option specifies the list to be printed (Table 10). 



ALL The ALL command performs all of the functions of 
the dispaly commands described above and the functions of 
ANLZ (except dumps) when it is initiated by the auto- 
matic recovery procedure. The format of the command is 

AL[L] 

A numerically and alphanumerically sorted monitor map is 
output at the end of the ALL display. 



INTERACTIVE MONITOR DISPLAY COMMANDS 

Commands in this group allow the user to examine either 
the dump or the running monitor. Both the monitor and 
user JIT and physical core may be examined. The com- 
mands are 

loc 

loci, loco 

Line feed (or carriage return) 

t 



MONITOR 



loc = value 



loc The loc command outputs the contents of the speci- 

fied location. The format of the command is 



where loc is one hexadecimal value (1 to 8 hexadecimal 
digits) or two hexadecimal values separated by an operator 
indicating addition (+), subtraction (-), multiplication (*), 
or division (%). Note that loc values do not require a pre- 
ceding delimiter character ". ". 
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Table 9. DISPLAY Command Options 



Option 


Meaning 


AJ [ITS] 


Displays J IT, AJIT, and context area of all incore users. 


at[able] 


Displays the items in ALLYCAT's tables used to manipulate buffers. 


av[r] 


Displays the AVR tables. 


ci[ts] 


Displays the CITs. 


co 4&}] 


Displays the contents of COC tables. S specifies all users and id specifies a 
specific user. The default is S. 


cu[n] 


Displays the current user's JIT, AJIT, and context. 


dc[ts] 


Displays the DCTs. 


el[og] 


Displays the incore error log buffer-. 


FM 


Displays the read-ahead tables. 


FQ 


Displays I/O tables not currently in use. 


4i?J] 


Displays user's logon identification as it appears in his JIT. S specifies all 
users and id specifies a specific user. The default is S. 


IO[Q] 


Displays channel information (CIT), device control (DCT), and I/O queue (IOQ) 
tables. 


IQ 


Displays the IOQs. 


Jl[T]id[joc r loc 2 ] 


Displays the contents of JIT (between displacement locations locj and loco) for 
a particular user where id specifies the user identification assigned by the 
system. 


MR 


Displays the monitor's root. 


Oj[lTS] 


Displays the JIT of all users not in core. 


PA[RTITION][{^jl 


Displays the partition table values. S specifies all users and id specifies a 
specific user. S is the default. 


pf[ile] 


Displays the patch file created at system boot time. 


PM 


Displays the contents of the page matrix, which identifies owners of physical 
pages. 


PP, pgno 


Displays the contents of a physical page of memory. 


RA[T] 


Displays the resource allocation tables. 
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Table 9. DISPLAY Command (cont. ) 



Option 


Meaning 


REGISTERS] 


Displays the contents of the registers, the screech code, and an explicit cause of 
the crash. The text of the message associated with the screech code is obtained 
from the error message file ERRMSG in account :SYS with a group code of 08. 


RC[XT] 


Displays the recovery context. 


RQ 


Displays the resource sub-queue wait list. 


ST 


Displays the output symbiont tables. 


sw[ap] 


Displays the contents of the swap tables. 


sy[mbionts] 


Displays the input symbiont table values. 


tr[aps] 


Displays the contents of trap and interrupt locations. 


TS[TACK][,[id]] 


Dumps the Temp Stack for the indicated user (default id = 0, which indicates the 
monitor's stack), displaying values as symbol plus displacement. If the stack cell 
contains a monitor address, the instruction at that location will be displayed. 


US[ER][{f d }] 


Displays the contents of the tables for a particular user. S specifies all users and 
id specifies a specific user. S is the default. 


VP,pgno 


Displays the contents of a virtual page of memory. Note: To make a user's vir- 
tual memory available for this display, the MAP command must first be entered. 



Table 10. RUN Command Options 



Option 


Meaning 


MO [NIT OR] 


Specifies monitor pages. 


PR[OCESSOR][{ n S am j] 


Specifies processor pages or specific processor. The default is S, indicating 
all processor pages. 


r[eal time] 


Specifies real-time page chains. 


ST[ATE][,{ q S ,}] 


Specifies state queues. The number of a specific state queue may be specified 
(q*), or S indicates all. The default is S. 


USfe] [.{?„}] 


Specifies user pages for all users (S), or for a particular user. The default 
is S. 


x[delta] 


Specifies XDELTA's page chains. 
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l0C^,l0C2 This command outputs the contents of the 

memory focations between loc] and loc2« The format of 
the command Is 

locj, loc^ 

where loc: is a hexadecimal number or an expression indi- 
cating a sum or difference of two hexadecimal numbers. 

Two levels of loc; commands may be joined by the +, -, *, 
and % (division) operators. For example, the following are 
permissible: 

loc + loc.., loc_ 

loc - loc., loc^ 

loc , loc„ + loc 

loc., loc_ - loc 

loc, + loc_, loc - loc . 
1 2' 3 4 

| loc * loc~, loc~ % loc . 

The resultant dump suppresses identical lines and an * is 
inserted next to the line number following the identical 
line encountered. An EBCDIC translation is included to 
the right of the dump. 



LINE FEED The line feed (or carriage return) character 

may be used in conjunction with loc and locj, I0C2 com- 
mands to dump the contents of the next location. 



I This command may be used in conjunction with the 

loc and loc-|, I0C2 commands to dump the last location. 
The format of the command is 



lOC = value This command places the specified value into 

the specified location (loc) of the running monitor. (The 
display mode must be on.) The format of the command is 

loc = value 



loc is the specified location, 

value is the specified value. 

MAP COMMANDS 

These commands turn the map mode on and off. They work 
only with interactive commands and apply only to a partic- 
ular user. The two map commands are 

MAP 

UNMAP 



MAP The MAP command loads the map of the specified 

user if his JIT is in core. The format of the command is 

MA[P], id 

where id is the user identification assigned by the system. 
Dump output following a MAP command is assumed to be 
virtual addressed. 



UNMAP The UNMAP command turns the mapping mode 

of operation off. The format of the command is 

UN[MAP] 

Dump output following an UNMAP command is assumed to 
be physical addressed. 



* This command may be used in conjunction with the 
loc and loc], I0C2 commands to dump the location whose 
address is contained in the location specified by loc. The 
format of the command is 



SEARCH COMMANDS 

Commands in this group allow core to be searched. The 
commands are 



MONITOR The MONITOR command turns the monitor 

display mode on and off (as does any explicit command). 
When the display mode is on, the current monitor is dis- 
played. When the display mode is off, the dump is dis- 
played. The format of the command is 

mo[nitor] [di[splay]] 

where DISPLAY turns the monitor display mode on. Omis- 
sion of DISPLAY turns the monitor display mode off. 



COMPARE 

SMASK 

SEARCH 



COMPARE The COMPARE command compares dump lo- 

cations between loC| and loc2 with the running monitor, 
and outputs locations with nonequal contents. The format 
of the command is 



CO[MPARE],loc 1 ,loc 2 



Commands 43 



SMASK The SMASK command sets the mask to the 

specified value. The format of the command is 

SM[ASK],value 

where value is a hexadecimal mask. 



PRINT The PRINT command closes the output symbiont 

file to allow output to the line printer without requiring a 
return to TEL. The format of the command is 

PR [I NT] 



SEARCH The SEARCH command searches for and outputs 
all words between locations loc| and loc2 that contain the 
specified value under the mask. The format of the com- 
mand is 



SE[ARCH], value, loc^loc- 



/here 



is a hexadecimal value. 



loci is the beginning location and may be a hexa- 

decimal number or an expression indicating a sum 
or difference of two hexadecimal numbers. 

loco is the ending location and may be a hexadec- 

imal number or an expression indicating a sum or 
difference of two hexadecimal numbers. 



OUTPUT COMMANDS 

Commands in this group direct or format the output of 
ANLZ. Four output commands are provided: 

ROWS 
LP 
UC 
PRINT 

ROWS The ROWS command establishes the width of dump 

output. The format of the command is 

ROWS value 

where value is a number between 1 and 12. ROWS 1 would 
cause all hexadecimal dumps to be one word wide; ROWS 8 
would cause the dumps to be eight words wide. (Platen 
width may need to be extended at ROWS = 8. ) 

LP The LP command directs output from ANLZ to the 
line printer. The format of the command is 

LP [rows] 

where rows indicates the dump width in number of words. 

UC The UC command directs output from ANLZ to the 

on-line terminal. The format of the command is 

UC [rows] 

where rows indicates the dump width in number of words. 



DEBUG COMMANDS 

Commands in this group permit the use of Delta to facilitate 
monitor debugging. The three debug commands are 

BF 

DELTA 

NODELTA 



BF The BF command specifies the name of the boot file 
that represents the monitor being examined by ANLZ. 
This enables the debugger Delta to read in the required 
symbol tables. If the BF command is not specified, the file 
M:MON in :SYS is the boot file that is assumed by default. 

The form of the command is 

BF fid 

where fid is the file identification and is in the form 



[<; 



[account] . password] J 
account J 



DELTA The Delta command associates the debugger 
Delta with ANLZ and gives control to Delta. If the 
BF command has been issued, the Delta command ;S loads 
the global symbol table of the monitor root from the spe- 
cified boot file. The Delta command name ;S loads the 
local symbol table of the module named. If the BF com- 
mand was not executed, the file M:MON in :SYS is used 
to obtain the monitor symbol tables and the Delta com- 
mands apply to the running monitor being examined, not 
to the monitor in the boot file. The Delta command ;G 
is used to exit from Delta and to return control to ANLZ. 

The form of the DELTA command is 
DE[LTA] 



NODELTA The NODELTA command disassociates the 

debugger Delta from ANLZ. The form of the command is 



NO [DELTA] 
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MISCELLANEOUS COMMANDS 

SYMBOLS This command creates an alphanumerically 

sorted monitor map by reading, sorting, and formatting the 
monitor's REF/DEF stack in the file MONSTK. :SYS. 

The form of the command is 

SY[MBOLS] [fid] 

where fid is used to select symbols from a file and has the 
format 



name 



[t 



account] . password 



•account 
MONSTK. :SYS is the default. 



IS This command reads the sorted symbol table that was 

saved the last time ANLZ ran as a ghost job. The command 
produces no output. When the IS command is used, the 
SYMBOLS command is unnecessary. The format of the IS 
command is: 



IS 



SYMBOL/ The symbol/ command displays the contents of 
a monitor location. The format of the command is 

symbol/ 

where symbol specifies the name of a location in the 
monitor. 

Note: The symbol table must have been retrieved by use 
of the SYMBOLS or IS command prior to use of this 
command. 



DUMP This command causes a specified range of ad- 

dresses to be dumped. The command's format is 

DUMP loc.Joc. 

Dump output following a MAP command is assumed to be 
virtual addressed; after an UNMAP command, physical 
addressed. 



CLOSE This command causes the input dump file to be 

closed. The format is 

CL[OSE] 

A user should close a file prior to entering the monitor dis- 
play mode. 

HELP This command lists all ANLZ commands and op- j 
tions, and gives a brief description of the purpose of each. 
The form of the HELP command is 



HE[LP] 



EXIT COMMANDS 



END The END command causes an exit from ANLZ. 

The format of the command is 



EN[D] 



OUTPUT 



The output produced by ANLZ consists of displays of for- 
matted monitor and user tables and the contents of registers 
existing at the time of the crash. The time and date infor- 
mation in the output page headings refer to the time at 
which the crash occurred. 

Some of the output tables are chain type displays. That is, 
they are formed by starting at the head of a chained list and 
outputting that list until the tail of the chain is reached. If 
the tail and the last page in the chain do not agree, the fol- 
lowing message is output: 



TAIL ERROR 



If the count differs from the number of pages in the chain, 
the following message is output: 



COUNT ERROR 



Table 11 lists all of the ANLZ displays in order of appear- 
ance in the ANLZ dump. The left-hand column specifies 
the heading that appears at the top of each display. The 
right-hand column describes the contents of the display. 



Table 11. Displays 



Heading 


Contents 


REGISTERS: 


The contents of the registers at the time the dump was taken. 


TRAPS/INTERRUPTS: 


The output for trap and interrupt locations. Thetrapand interrupt locations 
are those used by the associated XPSD instructions and are listed in Table 12. 


PAGE IN WHICH TRAP OCCURRED: 


The core page in which the trap occurred, if a trap was the cause of 
the recovery. 
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Table 11. Displays (cont.) 



Heading 




Contents 


USER TABLES: 


The user tables. This display includes the tables associated with each 
user that has a page chain. The meaning and source of items in this dis- 
play are defined in Table 13. 


ADDITIONAL USER TABLES: 


The remainder of the User Tables display above. The meaning and source 
of items in this display are defined in Table 14. 


USER STATE CHAINS: 


The user state chains which indicate the state of each user in the system. 


RESOURCE WAIT QUEUES: 


The queues of users waiting for resources. The queues are listed and de- 
fined in Table 15. 


SWAP TABLES: 


The swap tables. The meaning of each location in the table is defined 
in Table 16. 


PARTITION TABLES: 


The partition tables. Table 17 defines the headings in this display. 


PROCESSOR TABLES: 


The processor tables. Table 18 defines the headings in the display. 


MONITOR (FREE) PAGE CHAIN: 


The monitor free page chain. The swapper page chain is formatted in 
the same manner as this display. Usually there is no page chain data 
output. 


USER PAGE CHAINS: 


The user page chain display. This display indicates which pages and how 
many pages were being used by the various users resident in core. 


PROCESSOR PAGE CHAINS: 


The processor page chain display. This display indicates which pages and 
how many pages were being used by the various processors resident in core. 


READ AHEAD TABLES: 


The read-ahead tables. 


REAL TIME PAGES: 


The real-time page chain. 


XDELTA/HANDLER PAGE CHAINS: 


XDELTA's page chain. 


PHYSICAL MEMORY ALLOCATION: 


The actual physical memory allocation on a page-by-page basis. This 
display is a composite picture of the monitor free page chain, user page 
chain, and processor page chain displays, plus the resident monitor and 
its JIT, plus any unallocated pages. 


ALLYCAT TABLES: 


The ALLYCAT buffer adjustment tables. The headings used in this dis- 
play are defined in Table 19. 


UNALLOCATED PAGES: 


The contents of any unallocated pages. 


I/O CHANNEL DEVICE STATES: 


The I/O channel and device states. The display is separated into tables 
pertaining to each logical channel. For each channel, ANLZ prints the 
channel information table (CIT), the device control tables (DCT) for de- 
vices on the channel, and the user J/O request queues on those devices. 
Table 20 defines the headings used in the display. 


FREE QUEUE ENTRIES: 


The free queues entries which are used to contain user I/O requests for 
I/O devices defined in the I/O Channel Device States display above. 


CHANNEL INFORMATION TABLE: 


The channel information tables (CIT). 


DEVICE CONTROL TABLES: 


The device control tables (DCT). Table 21 defines the meaning of 
the headings used in this display. 
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Table 11. Displays (cont. ) 



Heading 


Contents 


IOQ TABLES: 


The IOQ tables. Table 22 defines the meaning for the headings used in 
the IOQ tables display. 


COC TABLES: 


The COC tables. This display includes the line table values for those 
lines having an associated user (determined by a non-zero value in 
LB:UN). Table 23 defines the headings used in the COC tables display. 


RESOURCE ALLOCATION TABLES: 


The resource allocation tables. 


AVR TABLES: 


The AVR tables. Table 24 defines the headings used in the AVR fables 
display. 


IN CORE ERROR LOG DATA: 


The contents of the incore error log buffers. 


OUTPUT SYMBIONT TABLES: 


The output symbiont tables. The headings used in this display are 
defined in Table 25. 


*** ASSIGNED C POOLS: 
*** AND THEIR SPOOLS: 


The contents of the assigned CPOOLs and corresponding SPOOLs. 


MONITOR JIT: 


The monitor JIT contents and the monitor TSTACK contents. TSTACK 
headings are defined in Table 26. 


CURRENT USER: 


The current user's JIT. 


CONTENTS OF TSTACK: 


The current user's TSTACK. TSTACK headings are defined in 
Table 26. 


ADDITIONAL JIT FOR USER# nn: 


The current user's AJIT (additional JIT). 


CONTEXT AREA FOR USER# nn: 


The current user's context area. 


*** PHYSICAL PAGE# nn: 


The current user's physical pages. 


MONITOR ROOT: 


The monitor root. 


RBBAT RECOVERY FILE: 


The RBBAT recovery file, which includes ghost communication buffers, the 
RBBAT environment, the RBBAT static data, and the RBBAT dynamic data. 
(Usually there is no dynamic data output.) 


USER IDENTIFICATION: 


The user identification. This display is a composite of all JITs in the 
MONDMPfile. 


PATCH FILE- 


The patch file built by GHOST1 at system boot time. 


INSWAP USER: 


The current inswap and outswap users' core (if any). This figure has the 
same format as the Incore Users display. 


INCORE USERS: 


The current incore users' core. 


CONTROL SECTION MAP: 


A map of the monitor modules' start addresses. 


SYMBOL MAP: 


The symbol map. 


TABLE OF CONTENTS: 


The Table of Contents for the ANLZ dump. 
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Table 12. Trap and Interrupt Locations for XPSD 
Instructions 



Table 13. User Table Headings 



Location 




Name of 


of XPSD 


Meaning 


Handler 


X'40' 


Nona Mowed operation trap 


NOPPSD 


X'4T 


Unimplemented instruction 
trap 


UN IMP 


X*42' 


Stack overflow trap 


STKOVF 


X'43' 


Fixed-point arithmetic 
overflow 


FIXOV 


X'44' 


Floating-point fault 


FLTFLT 


X'45' 


Decimal arithmetic fault 


DECFLT 


X'46' 


Watchdog timer runout 


CSE$ERR 


X'47' 


Multiprocessing usage 


IPT47 


X'48' 


CAL1 instruction 


CAL1PSD 


X'49' 


CAL2 instruction 


CAL2PSD 


X'4A' 


CAL3 instruction 


CAL3PSD 


X'4B' 


CAL4 instruction 


CAL4PSD 


X'4C' 


Hardware error trap 


CSE$ERR 


X'4D' 


Instruction exception trap 


CSE$ERR 


X'4E' 


XDELTA entry 


LEE20 


X'4F' 


JIT pointer 


- 


X'50' 


Power on 


PON PSD 


X'51' 


Power off 


POFPSD 


X»54' 


CLOCK3 counter 


- 


X'55' 


CLOCK4 counter 


- 


X'56' 


Parity error 


PERPSD 


X'58' 


Counter 1 zero 


CLK1PSD 


X'59' 


Counter 2 zero 


CLK2PSD 


X'5A' 


Counter 3 zero 


CLK3PSD 


X'5B' 


Counter 4 zero 


CLK4PSD 


X'5C 


Input/output interrupt 


IOPSD 


X'5D' 


Control panel 


OCPSD 


X'60' 


COC input interrupt 


COCIN1 


X'6T 


COC output interrupt 


COCOUT1 



Heading 


Source 


Meaning 


USER 


- 


Internal user number. 


ST 


UB:US 


User's state. 


BL 


UB:BL 


Link to previous user in 
same state. 


FL 


UB:FL 


Link to next user in same 
state. 


FLG 


UH:FLG 


User's flags. 


FLG2 


UH:FLG2 


Exit control bits, miscel- 
laneous control flags. 


JIT 


UB-JIT 


Physical page address of 
user's JIT. 


SWPI 


UBrSWAPI 


Swap table index. 


HJIT 


UH-JIT 


Track/sector address on 
the swapping RAD of 
user's JIT. 


AJIT 


UH:AJIT 


Track/sector address 
of user's additional 
JIT. 


PCT 


UBrPCT 


User's page count. 


ACP 


UB:ACP 


Number of associated 
command processor. 


APR 


UB.-APR 


Number of associated 
processor's root. 


APO 


UB:APO 


Number of associated 
processor's overlay. 


ASP 


UB:ASP 


Number of associated 
special processor. 


DB 


UB:DB 


Number of associated 
debugger. 


OV 


UB:OV 


Number of associated 
overlay. 


MF 


UBrMF 


Number of I/O events 
outstanding. 
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Table 14. Additional User Table Headings 



Heading 


Meaning 


USER 


User number. 


MISC 


Either rime left for user to remain asleep 




or resource wait queue forward link. 


UH:DL 


DO- list address. 


PC# 


User's procedure cylinder number if disk 




pack swapper. 


DC# 


User's data cylinder number if disk pack 




swapper. 


PRI 


User's current priority. 


PRIB 


User's priority base value. 


NECB 


Number of ECBs to be posted for this 




user. 


UH:NL 


Pointer to head of ECBs to be posted. 



Table 15. Resource Wait Queues 



Name 


Description 


RrSYMF 


Users queued for symbiont file space. 


R:SYMD 


Users queued for symbiont disk granule. 


R:OCR 


Users queued for OPEN/CLOSE. 


R:DPA 


Users queued for swapper granule. 


R:QFAC 


Users queued for ALLOCAT. 


R:NQW 


Users queued for ENQ. 



Table 16. Swap Table Terms 



Location 


Meaning 


S:SIR 


Swap in requests posted. 


S:HIR 


High priority requests posted. 


S:SIP 


Swap- in progress flag. 


#SWAP$DEV 


Interrupt bypass count. 


S:CUN 


Current user number. 


SrISUN 


In-swap user number. 



Table 16. 


Swap Table Terms (cont.) 


Location 


Meaning 


S.-CUIS 


Count of users in system. 


S:IDLF 


Idle flag. 


SB:OSN 


Number of out-swap users. 


SB:OSUL 


Out-swap user list. 


S-.BECL 


Beginning and end command list 




for each outswap user. 


SB:NP 


Number of in-swap processors. 


SB:PNL 


In-swap processor numbers. 


SB.-FPN 


Number of freed processors. 


SB:FPL 


List of freed processors. 


M:SWAPD 


Address of swap device. 


MB:SDI 


DCT index. 


MB:SFC 


Swap function code. 


MB: # RTRY 


Retry count. 


MrCLBGN 


Beginning of current command 




list. 


MH.-CLEND 


End of current command list. 



Table 


17. Partition 


Tables Headings 


Heading 


Source 


Meaning 


# 


Calculated 


Index to partition tables. 


ACCOUNT 


PLDrACT 


Current running account. 


USR 


PLBrUSR 


Number of users in 
partition. 


FLG 


PLH:FLG 


Partition control flags. 


QN 


PLH:QN 


Quantum time of 
partition. 


TOL 


PLHrTOL 


Total jobs run in this 
partition. 


CUR 


PLHrCUR 


Current jobs selected in 
this partition. 


TL 


PLH:TL 


Lower time limit. 


TU 


PLH:TU 


Upper time limit. 


SID 


PLH:SID 


System ID. 



Output 49 



Table 18. Processor Table Headings 



Heading 


Source 


Meaning 


p# 


- 


Processor index number. 


P:NAME 


P:NAME 


Processor name. 


HPP 


PB:HPP 


Head of processor's physical page chain. 


TPP 


PB:TPP 


Tail of processor's physical page chain. 


PSZ 


PB:PSZ 


Processor's procedure size in pages. 


DSZ 


PB:DSZ 


Processor's initial data size in pages. 


DCBSZ 


PB:DCBSZ 


Size in pages of DCB area. 


PDA 


PH:PDA 


Disk address of procedure. 


DDA 


PH:DDA 


Disk address of data and DCBs. 


UC 


PB:UC 


Use count on processor. 


LNK 


PB:LNK 


First overlay number for this processor. 


PVA 


PB:PVA 


Virtual page address of the processor's procedure. 


HVA 


PB:HVA 


First page available to the processor. 


pc# 


PB:PC # 


Procedure cylinder number. 


DC # 


PB:DC # 


Data cylinder number. 


SA 


P:TCB 


Starting address and flags. 


TCB 


P:TCB 


TC B address . 





Table 19. ALLYCAT Headings 


Heading 


Meaning 


TOP 


Top index into buffer. 


BOTTOM 


Bottom index into buffer. 


WORDCNT 


Number of disk addresses in buffer. 


TEMPBOT 


Set if ALLYCAT changing buffer. 


BUFLAGS 


Bit = HGP empty, Bit 1 = buffer just filled, Bit 2 = buffer just emptied. 


ADJSTCNT 


Number of entries manipulated by ALLYCAT; may be either positive or negative. 


GRANULES AVAIL 


Total number of granules/cylinders remaining in system (in hexadecimal notation). 
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Table 20. I/O Table Headings 



Table 21. Device Control Table Headings (cont.) 



Heading 


Meaning 


CIT3-5 


Channel Information Tables 3-5 


DEVICE 


yyndd for this device 


ADDR 


Hardware address 


CX 


Channel index 


OIDTS 


From DCT3 - Set bits indicate: 




O output 




I input 




D down 




T timed out 




S SIO reject 


BPWXKCSB 


From DCT5 - Sets bits indicate: 




B Device busy 




P Clean-up pending 




W Wait until done 




X Data transfer 




K Wait for key-in 




C Control task 




S SIO while manual 




B BIN mode 


QX 


I/O queue index 


AIO 


Last AIO status 


TDV 


Last TDV status 



Table 21. Device Control Table Headings 



Heading 


Meaning 


# 


DCT number. 


DEV 


Active I/O address. 


PR I 


Primary I/O address. 


ALT 


Alternate I/O address. 


CIT# 


Channel (CIT) index. 



Heading 


Meaning 


IO FLG 


I/O legality: 




1 1 = in and out 




10 = out only 




01 = in only 


DEV TYP 


Type mnemonic. 


DEV FLGS 


State of device. 


IOQ # 


IOQ index. 


CDW ADRS 


Command doubleword address (WA 
resolution). 


PRE HAND 


Handler preprocessor word address. 


POST HAND 


Handler postprocessor word address. 


ACT CNTR 


Device activity counter. 


IOINT 
DEADLINE 


Value to match against I/O 
clock. 


AIO INT STAT 


AIO status word. 


TDV STATUS 


TDV status doubleword. 


CHAN FLNK 


Link to next entry. 


PRE-EMPT 


Real-time pre-empt flag. 


is 


7446 table. 


HAND CODES 


Handler function flags (first 8 bits 
contain retry function code; the 
second 8 bits contain the fol- 
low on code). 


TIME INCR 


Time-out increments. 


SIOCC 


SIO condition codes. 


TDVCC 


TDV condition codes. 


TIO STATUS 


TIO status. 


DISC FLAG 


Disk flag. 


HGPDISP 


Heading Granule Pool (HGP) 
displacement if disk. 


RMA FLGS 


Partitioning flags. 


SIO COUNTER 


Number of SIOs done to this 
device. 
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Table 22. IOQ Table Headings 



Heading 


Meaning 


# 


IOQ table number. 


BAK 


Back link to next entry. 


FWD 


Forward link to next entry. 


DCT # 


DCT index. 


MIME 


TEXT name of device from SYSGEN. 


STAT 


Software status. 


FCN 


Original function code (IOQ4). 


CODS 


Current function code (IOQ5). 


DC BAD 


DCB word address (if any). 


BUF 


Buffer word address if bit and 1 reset; 
CDW word address if bit 1 set (swapper); 
CDW word address if bit set (other). 



Table 


22. IOQ Table Headings (cont.) 


Heading 


Meaning 


TIM 


Number of timeout increments. 


CDW 


Number of commands used if IOQ8 




bit or 1 set. 


NRA 


Original number of recovery tries. 


NRT 


Remaining number of recovery tries. 


RAD AD 


Disk address. 


EAADR 


End action word address. 


E A INFO 


One word to return to end action 




receiver. 


PRIO 


Priority of this event. 


USER 


User number of I/O requester. 



Table 23. COC Line Table Headings 





Heading 


Source 


Meaning 


LINE 


Calculated 


Line number. 


USER 


LB:UN 


Associated internal user. 


TYPE 


COCTERM 


Terminal type. 


EOMTIME 


EOMTIME 


End of message time for a read. 


BUFCNT 


BUFCNT 


Number of buffers in use for line. 


CPOS 


CPOS 


Current carriage position. 


RSZ 


RSZ 


Record size requested by user while read is pending. 


MODE BYTES 


MODE-MODE4 


Terminal mode indicators. 


TL 


TL 


Pointer to tab buffer. 


II 


COCII 


Input insertion pointer for line. 


IR 


COCIR 


Input removal pointer for line. 


ARSZ 


ARSZ 


Accumulated record size while read is pending. 


CPI 


CPI 


Initial carriage position for a read. 


OI 


COCOI 


Output insertion pointer for line. 


OR 


COC OR 


Output removal pointer for line. 


OC 


COCOC 


Count of characters pending output. 
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Table 


24. AVR Table Headings 


Heading 


Meaning 


SER# 


Serial number of tape or pack. 


PUB 


Set if public. 


POS 


Set if positioned. 


AVR 


Set if AVRed. 


SCR 


Set if scratch tape. 


HLD 


Set if held. 


PTL 


Set if positioned to label. 


UPL 


Set if user positioned label. 


OPN 


Set if open. 


NOU 


Number of users. 


TPOS 


Tape mark count. 


USER 


User number. 


SOLICIT 


Index to special AVR tables. 


INI 


Set if volume initialized. 


VER 


Set if volume verified. 


MTD 


Set if mounted. 


PRIM 


Set if primary volume of private 




set of volumes. 


HGPDISP 


Displacement from HGP. 



Table 25. Symbiont Table Headings 


Heading 


Meaning 


# 


Index number of table. 


SQUE 


Symbiont queue chain. 


SNDDX 


DCT index of symbiont device. 


TYPE 


TEXT name of symbiont device 
from SYSGEN. 



Table 25. 


Symbiont Table Headings (cont.) 


Heading 


Meaning 


SSTAT 


Symbiont Status: 




= input symbiont 




1 = output symbiont 


SSIG 


Symbiont signal character (e.g., 




L, Q, etc.). 


SRET 


Symbiont return when activated 




from chain. 


SCNTXT 


Context block dcubleword address 




displacement. 


SYMX 


Symbiont index: 




1 = input 




2 = output 


TYP 


Device type. 


LNK 


Remote chain. 


FLAG 


Remote flags. 


SUSP 


Suspend bit for IRBT. 


QUE 


IOQ index for IRBT. 


SQHD 


Symbiont queue chain head. 


SQTL 


Symbiont queue chain tail. 



Table 26. TSTACK Headings 



Heading 


Meaning 


ADDRS 


Virtual address of displayed contents. 


STACK OFFSET 


Index into stack. 


CONTENTS 


Contents of stack. 


RELATIVE LOC 


Address that stack contents point to, 
in symbol plus displacement form. 
If the stack cell contains a relative 
location, the instruction at that lo- 
cation will be displayed if it is an 
address modifying instruction (e.g., 
B, BAL, LPSD). 


INSTRUCTION 


Symbolic instruction at the address 
contained in the stack position. 
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ANLZ MESSAGES 

Table 27 contains the messages that are output by ANLZ. 
Most of these messages identify error conditions. Others 
merely supply information. 



ANLZ COMMAND SUMMARY 

Table 28 summarizes ANLZ commands. The left-hand 
column contains the command format, the right-hand column 
contains the command description. 



Table 27. ANLZ Messages 



Message 


Description 


ANALYZE HERE 


The ANLZ program has begun operation. 


ANLZ: ENTER COMMAND, N/L SAYS TO DO ALL 


This message issued to operator after GJOB ANLZ key-in. 
Operator may respond with one of the following: 

NO = just exit 

TA = read recovery-built tape 

HE = run interactively from console 

CP =read CP5DMP file 

0-7 = read indicated MONDMP file 

N/L = do default ghost run 


ANLZ GHOST FINISHED 


The ANLZ ghost has completed processing the core 
image file. 


ANLZ USING MONDPMn 


ANLZ has been commanded to read a MONDMP file. 
The value specified for n indicates the number of the 
MONDMP file. 


BAD COMMAND 


The command was unrecognizable. 


CANNOT OPEN FILE name 


The file specified by the INPUT command cannot be opened. 


CAN'T GET THE BUFFER 


The user was not allowed enough core in his account to 
read in the monitor symbol stack. 


COUNT ERROR 
TAIL ERROR 


The tail and last page in a chain do not agree. 


ENTER TAPE TYPE: 7T # 9T, BT, ETC. . . 


The user must supply the tape type if tape input is to be used. 


ERR/ABN CODE = xxxx**dcb 


An I/O error or abnormal condition occurred during an 
INPUT operation. 

xxxx is the error or abnormal code. 

deb is the address of the DCB associated with it. 


LOCI > LOC2 


The first location entered for a Iocj,loc2 (or similar) com- 
mand was greater than the second location. 


xx PRIVILEGE LEVEL NOT HIGH ENOUGH 


The user privilege level was not high enough for the 
requested operation. 


SORRY, NO PAGE xx 


The page containing the location specified by the user 
was not found in the input file. 


THE LAST PHYSICAL PAGE IN THE FILE IS xx 


The size of the file read from tape by the INPUT com- 
mand is specified by the last physical page in the file. 
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Table 28. ANLZ Command Summary 



Command 


Description 


t 


Dumps the last location and is used in connection with loc 
and locj, I0C2. 


* . 


Dumps the indirect location and is used in conjunction with 
loc and loc], I0C2. 


AL[g 


Performs the functions of the INPUT, DISPLAY, and RUN 
commands and of ANLZ (except dumps) when initiated 
by the automatic recovery procedure. A numerically and 
alphanumerically sorted monitor map is output at the end of 
the ALL display. 


BF fid 


Specifies the name of the boot file that represents the monitor 
being examined by ANLZ. The file M:MON in :SYS is as- 
sumed by default. 


CL[OSE] 


Causes input dump file to be closed. 


CO[MPARE] / loc 1/ loc 2 


Compares the dump (locations loc] through I0C2) with the 
running monitor and outputs the locations with nonequal 
contents. 


de[lta] 


Associates the debugger Delta with ANLZ. 


DI [SPLAY] option 


Outputs information existing at the time of the crash. "The 
options are 

AJ[ITSj — JIT, AJIT and context of all incore users. 

AT[ABLE] - contents of ALLYCAT's tables used to manip- 
ulate buffers. 

A V[R] - contents of A VR tables. 

Cl[TS] - contents of CITs. 

CO[C] , j. ,\ - contents of COC tables, id specifies 
user, S indicates all users. 

CU[N]- contents of user's JIT, AJIT, and context. 

DCJTS]- contents of DCTs. 

EL[0GJ — incore error log entries. 

FM— contents of read-ahead tables. 

FQ - contents of I/O tables not currently in use. 

ID l/ljjj.l - user's logon identification as it appeared in 

his JIT. id specifies user, S indicates all users. 

IO[Q] - contents of CIT, DCT, and IOQ tables. 

IQ - contents of IOQs. 

JI[T], id[,loc^ , I0C2]- JIT contents for specified user (id). 
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Table 28. ANLZ Command Summary (cont. ) 



Command 


Description 


DIJSPLAY] option (cont.) 


MR — contents of monitor root. 




Oj[lTSj — JIT of all users not in core. 




PARTITION] L ||J - partition table values, id speci- 
fies user, S indicates all users. 




PF[ILEj — contents of patch file. 




PM — contents of page matrix. 




PP / pgno — contents of physical page of memory. 




PROCESSOR] f, f.Jj - contents of processor tables, id 
specifies a user, S indicates all 
users. 




RA[Tj — contents of resource allocation tables. 




RE|GISTERSj — contents of registers, the screech code, 
and cause of crash. 




RCJXTJ — recovery context. 




RQ — resource sub-queue wait list. 




ST — contents of output symbiont tables. 




SW[AP] - contents of swap tables. 




SY[MBIONTS] - contents of symbiont tables. 




TR[APSJ —contents of trap and interrupt locations. 




TS[TACK][,[id] —dumps out the indicated Temp Stack 
for the indicated user (user ' = 
for monitor's stack), displaying 
values as symbol + displacement. If 
the stack cell contains a monitor 
address, the instruction at that loca- 
tion will be displayed. 




US[ERj 1/ j. i| I — contents of tables for specified user, id 
specifies a user, S indicates all users. 




VP, pgno — contents of virtual page of memory. 


DU[MP] lo Cl/ loc 2 


Dumps specified range of addresses. 


en[d] 


Exits from ANLZ. 


he[lp] 


Lists all ANLZ commands. 


IN [PUT] option 


Directs ANLZ to input from a particular disk or tape file or 
to open a file. The options are 




;[VJ — reads a tape created by executive Delta. 




LA[ST]— opens the last file formed by the recovery 
procedure. 
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Table 28. ANLZ Command Summary (cont.) 






Command 


Description 


IN [PUT] option (cont.) 


number —opens the numbered crash file formed by the 




recovery procedure. 




TA[PE] — reads a labeled tape created by the recovery 




procedure. 




CP[5DUMP] -opens the CP5DUMP file. 


IS 


Reads the sorted symbol table from a previous ANLZ run. 


Line Feed (or carriage return) 


Dumps the contents of the next location and is used in con- 




junction with loc and loci,loco. 


loc 


Outputs the contents of the specified location. 


loc^loc^ 


Outputs the contents of memory locations between loc. 
and loco. 


loc = value 


Places the value in the specified location of the running 




monitor. 


LP [rows] 


Directs the output of ANLZ to the line printer, where rows 




is dump width in hexadecimal words. Default is full line. 


MA[P],id 


Loads the map of the specified user if his JIT is in core. 


mo[nitor][di[splay]] 


Turns the monitor display mode on and off. 




MONITOR turns the display mode off. 




MONITOR DISPLAY turns the display mode on. 


no[delta] 


Disassociates the debugger Delta from ANLZ. 


pr[int] 


Closes the output symbiont file to allow output to the line 
printer without requiring a return to TEL. 


RO[WS], value 


Establishes width of dump output in number of words, where 
value may be 1 through 12. 


RU[N] option 


Outputs various linked lists of the monitor by running through 
the list and displaying each entry. The options are 




MO[NITOR] 


I s 1 

_' lpgnoJ_ 


— monitor pages. S, the default, 
indicates all. A specific page 
may be requested. 




PROCESSOR] 


I s 1 

_' LnameJ_ 


— processor pages. S, the de- 
fault, indicates all. A par- 




ticular processor may be 
specified. 




R[EAL TIME] —real-time page chains. 




ST[ATE] 


[U 


— state queues. A particular queue 
number may be specified, or S, the 




default, indicates all. 



ANLZ Commands Summary 57 



Table 28. ANLZ Command Summary (cont.) 



Command 


Description 


RU[N] option (cont.) 


US[ER] , j . ,|j — user pages for a particular user (id), or 
L J for all users (S). S is the default. 

XJDELTA]- XDELTA's page chains. 


SEJARCH^value^oCwIoc 


Searches for and outputs all words between loc, and loc~ that 
contain the value under the mask. 


SM[ASK], value 


Sets the mask to the specified value. 


symbol/ 


Displays the contents of the monitor location specified by 
symbol. 


SY[MBOLS][fid] 


Creates a numerically sorted monitor map, using the fid spec- 
ified or MONSTK. :SYS. 


UC[rows] 


Directs the output of ANLZ to the on-line terminal, where 
rows is dump width in hexadecimal words. Default is full line. 


un[map] 


Turns off the mapping mode of operation. 
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5. ERROR MESSAGE FILE 



INTRODUCTION 

The error messages for the CP-V monitor and several CP-V 
processors are contained in an error message file, called 
ERRMSG. This file is initially created either through 
punched card or on-line terminal input and is maintained 
through use of the Edit processor. This chapter describes 
the structure of the ERRMSG file and the techniques 
required to create and modify the file. 

Codes for detected error conditions are recorded in the job 
information table (JIT). The error code is placed in J:ABC 
(high-order byte) and the subcode is placed in ERO (right- 
justified). When CCI (batch jobs) or TEL (on-line jobs) is 
entered, a message is printed to correspond to the code and 
subcode. This message is obtained from the error message 
file (ERRMSG) via a keyed read using a key constructed 
from the group code, error code, and subcode. If either 
the file or the record corresponding to the code is missing, 
the error code itself will be printed. Otherwise, the mes- 
sage and the error code will be printed. 



FORMAT OF ERROR MESSAGE FILE 

Each record in the error message file contains the EBCDIC 
text of one error message. The key of each record is one 
word long and has the form 



03 



GC 



EC 



SC 



1 2 3 14 5 6 7 8 9 10 1 1 112 13 14 15 16 17 18 191 20 21 22 23 24 25 26 27128 29 30 31 

The first byte always contains 03, which is the count of 
bytes in the key. The second byte is the group code, the 
third is the error code, and the fourth is the error subcode. 

Group codes presently assigned are 






Monitor 


5 


CCI 


1 


PCL 


6 


DRSP 


2 


Loader 


7 


Batch 


3 


TEL 


8 


Analyze 


4 


Runner 







Messages in the file with group codes other than zero are 
not handled by the monitor itself. Error codes currently 
assigned within the monitor group are 

— 7F I/O error and abnormal codes 

80 - 9F COBOL error codes 

A0 - BF Other Monitor codes 

CO - FF Unused 



The meaning of the assigned codes are defined in CP-V/TS 
Reference Manual, 90 09 07, CP-V/BP Reference Manual, 
90 17 64, and in the ANS COBOL/LN Reference Manual, 
90 15 00. 

CREATING ERROR MESSAGE FILE 

The ERRMSG file is initially entered into the system either 
through a card reader or an on-line terminal at the central site. 
The procedures for each type of input are described below. 



CARD READER INPUT 

Card input of the error message file is handled by the Error 
Message File Writer (ERRMWR). This program reads cards, 
interprets the first six columns as a hexadecimal number, 
converts this number into a three-byte key, and writes the 
card image exclusive of trailing blanks as a keyed record 
in the ERRMSG file in the account under which ERRMWR is 
executed. This account should be :SYS for the system error 
message file. 

The card format is 

1 2345 6 78 9 10 11 12 13 14 15 16 17 18 19 2021 22 



Hex. code 



GC 



EC 



S C 



Text of Message 



Example: 

Assume that the message ILLEGAL OPCODE is to be placed 
in the error message file for the monitor error code AE. The 
group code and subcode in this case are both zero. Thus, 
the card for this message would be punched as follows: 

A 2 3 456 789 10 11 12 13 14 15 16 17 18 19 20 



Hex. code 



00 



AE 



00 



Text of Message 



ILLEGAL OPCODE 



Keys generated by the ERRMWR program have the form 



03 



GC 
(col. 1-2) 



12 3 I 4 5 6 7 



EC 
(col. 3-4) 



9 10 III 12 13 14 15116 17 18 19120 21 22 23124 25 26 27128 29 30 31 



SC 

(col. 5-6) 



During conversion of the key, leading blanks are treated as 
zeros. Nonhexadecimal letters result in output of a warning 
message and cause the card to be ignored. The card image 
is scanned from right to left to determine the rightmost non- 
blank character, and the count of characters is adjusted so 
that trailing blanks are not written. A new line character 
X'15 1 is appended to the message. 
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The message may be continued in column 1 of the follow- 
ing card by appending a continuation character (;) at the 
end of the message in the first card. Only two cards per 
message are allowed. 

A card containing an asterisk in column 1 is a control card 
and is used to set the format of the record written in the 
file. If column 2 of the control card contains a 0, the 
message key is appended to the front of the message text 
and is included in the record. If column 2 of the control 
card contains a 1, the key is not included in the record 
text (this is the default condition). Control cards can be 
placed anywhere within the data deck except between 
continuation cards. 



TERMINAL INPUT 



Creating or modifying the error message file can be ac- 
complished from the terminal by using Edit or ERRMWR. 



Example 1: Using Edit 

1BUILD MSG © 

1 .000 00 A BOO THAT'S NO DEBUGGER!® 
2.000 00AB01 THAT'S NO OP CODE 
3.000 ® 

1SET M:EI DC/MSG © 

IERRMWR© 



Example 2: Using ERRMWR 

|SET M:EI UC® 

IERRMWR© 

>00AC01 DON'T ISSUE CAL3 OR CAL4© 

>© 
i 
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6. SYSTEM ERROR LOG FILE 



INTRODUCTION 

All hardware malfunctions and some software problems 
occurring during system operation, whether recovered or 
not, are recorded in a special disk storage file. This file 
is periodically copied into a standard file (ERRFILE) by a 
ghost program (ERR:FIL) which is initiated automatically 
for that purpose. 

ERRFILE may be listed and summarized by the Error Log 
Listing processor that is described in this chapter. ERRFILE 
is also available for on-line preventive maintenance of 
the system and for diagnosis and prediction of hardware 
malfunctions. 



ERR:FIL PROGRAM 

ERRrFIL copies the special file created by ERRLOG onto a 
normal keyed file (ERRFILE) in the :SYS account that is more 
readily available to diagnostic programs. 

ERRrFIL is a ghost job that is awakened by ERRLOG when- 
ever five errors have been recorded. ERR:FIL may also be 
awakened by a program with diagnostic privilege by using 
the initiate job CAL(CAL1,6 FPT)or by an operator key-in 
of GJOB ERR:FIL. 



ERROR LOG LISTING PROCESSOR 

The Error Log Listing processor (ELLA) provides an efficient 
tool for listing and sorting the error log file, ERRFILE, which 
is automatically generated and updated by the CP-V system. 
(ERRFILE is described in Appendix E. ) ELLA output furnishes 
a meaningful and comprehensive diagnostic evaluation of 
the system and its peripherals, aiding in the early detection 
of product failures and thus increasing the reliability, main- 
tainability, and availability of the system. 

The set of ELLA commands allows the user to first specify 
the kinds of errors in which he is interested, and then re- 
quest a listing of those kinds. Four types of listings are 
available: 

• A chronological listing of error log entries. 

• A sorted listing of error log entries. 

• A summary of error log entries by category. 

• A summary of error log entries in graphic form. 

STARTING EXECUTION 

ELLA may be run as an on-line, batch, or ghost job. Normal 
operating procedures are observed in each of these modes. 
Batch and on-line operations are illustrated in Examples 1 



and 2. These first two examples are intended only for ELLA 
users who are not familiar with CP-V. 

The use of ELLA is restricted to authorized system users whose 
accounts have a diagnostic privilege level (AO or higher). 
If the user has insufficient privilege, ELLA will abort with 
the message 



INSUFFICIENT PRIVILEGE LEVEL ABORT 



Note: Initiating ELLA as a ghost job enables the operator 
to issue ELLA commands from the operator's console. 
However, judgement should be exercised when ini- 
tiating ELLA in this fashion since ELLA commands 
will be intermixed with normal operator console 
material. 



INPUT/OUTPUT ASSIGNMENTS 

ELLA input and output is divided into three separate 
functions: 

• Error log input. 

• User command input. 

• Listing output. 

Error log input is always taken from the system error log file, 
ERRFILE. Without user intervention, the remaining two 
functions assume default assignments depending on the mode 
in which ELLA is run. The default assignments are listed in 
Tables 29, 30, and 31. (They are based upon the assumption 
that the SI and LO operational labels weregiven the standard 
assignments during SYSGEN. ) The assignment of the output 
listing function may be altered by the user during ELLA ex- 
ecution through use of the ELLA SET command. The tables 
specify the ELLA SET command formats that are required to 
make the reassignments. The SET command is described in 
detail below. 



SET The SET command reassigns the listing and message 

output device assignment during execution of ELLA. (It 
changes the device assignment in the M:LO DCB. ) The for- 
mat of the command is 



SET, LIST, {£} 



where 

LP specifies line printer. 

KP specifies operator's console for the ghost and 
batch modes and on-line terminal for the on-line 
mode. 
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Example 1. Batch Operation of ELLA 




For batch operation of ELLA, control commands and ELLA commands are punched on cards and the cards are submitted 
to the site operator. 

In this example, the account number (FEOPER) and account name (SITE 102) were chosen because they had been re- 
served for diagnostic activity at that particular site. In order to run ELLA in the batch mode, the account was 
authorized a privilege level of A0. (The privilege level is not specified on the JOB card because it is automatically 
associated with the account. ) The execution priority E was specified to given the job a high execution priority. (The 
privilege level determines the types of things that a job is allowed to do; the execution priority is a determining fac- 
tor in how quickly a job will be selected for execution. ) 



Example 2. On- Line Operation of ELLA 



XEROX CP-V AT YOUR SERVICE 

ON AT 13:48 JUL 08, '74 

LOGON PLEASE: FEOPER, SITE1 02 ,RSD © 

JELLA© 

13:49 JUL 08, '74 

ELLA 7080D6-A00 



*END© 
JPRINT © 

JOFF© 

In this example, the user logged onto the system after receiving the CP-V salutation and log-on request. The account 
number and name used are the same as in the previous example. (The account was authorized for both batch and on- 
line operations. ) The account has a password associated with it which is to be used for security reasons during on-line 
operation; i.e., if the password is kept confidential, it prevents unauthorized on-line use of this special diagnostic 
account. The password is entered following the name and account. Here, the password RSD was entered. 
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After the log-on, CP-V prompted for input with an exclamation point. The user entered 

ELLA© 

to request the Error Log Listing program and ELLA respondedwith its salutation and prompted for input with an asterisk. 
The user then entered ELLA commands, finishing with the END command which returned control to the system. The 
system then prompted with an exclamation point. (Actually, control was returned to a system command processor 
called TEL which is described in detail in the CP-V/TS Reference Manual, 90 09 07.) 

ELLA can output its listing on the user's terminal or on the line printer. If printer output is selected, the system holds 
the output on a disk file until either the PRINT or OFF command is entered. In the example, the user executed the 
PRINT command which caused the system to produce the printer output. The user then proceeded to perform other 
tasks, eventually ending the on-line session with the OFF command which logged the user off the system. 



INPUT/OUTPUT CHARACTERISTICS 

Whenever ELLA listing output is assigned to the line printer, 
the output contains two additional types of information: 
user commands received and diagnostic messages. ELLA 
user commands are listed on the printer to present a com- 
plete record of the user listing session. They are preceded 



by one asterisk. Diagnostic messages (due to abnormal con- 
ditions or operational errors) are preceded by two asterisks. 

Whenever the command input function is assigned to the 
operator's console (ghost initiation of ELLA) or the user's 
terminal (on-line initiation), diagnostic messages are 
printed on that input device (preceded by two asterisks) as 
well as on the line printer. 



Table 29, ELLA On-Line I/O Functions 



Function 


Associated 
DCB 


Default 
Assignment 


Possible 
Assignments 


ELLA SET 

Reassignment 
Command 


Comments 


Source 
error log 


M:BI 


ERRFILE 


ERRFILE 


(none) 


Data base from which ELLA reads source records 
for printing. 


Command 
input 


M:SI 


User's 
terminal 


User's 
terminal 


(none) 


Device from which ELLA reads commands (and 
to which it prints diagnostic messages). 


List 
output 


M:LO 


User's 
terminal 


User's 
terminal 


SET, LIST, KP 


Device to which ELLA lists error log data. 


Line 
printer 


SET, LIST, LP 


Device to which ELLA lists error log data, com- 
mands received, and diagnostic messages. 



Table 30. ELLA Batch I/O Functions 



Function 


Associated 
DCB 


Default 
Assignment 


Possible 
Assignments 


ELLA SET 

Reassignment 

Command 


Comments 


Source 
error log 


M:BI 


ERRFILE 


ERRFILE 


(none) 


Data base from which ELLA reads source records 
for printing. 


Command 
input 


M:SI 


Card 
reader 


Card 
reader 


(none) 


Device from which ELLA reads commands. 


List 
output 


M:LO 


Line 
printer 


Line 
printer 


SET, LIST, LP 


Device to which ELLA lists error log data, com- 
mands received, and diagnostic messages. 


Operator's 
console 


SET, LIST, KP 


Device to which ELLA lists error log data and 
diagnostic messages. (Using the operator's con- 
sole for lengthy messages is not recommended.) 
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Table 31. ELLA Ghost I/O Functions 



Function 


Associated 
DCB 


Default 
Assignment 


Possible 
Assignments 


ELLA SET 

Reassignment 

Commands 


Comments 


Source 
error log 


M:BI 


ERRFILE 


ERRFILE 


(none) 


Data base from which ELLA reads source records 
for printing. 


Command 
input 


M:SI 


Operator's 
console 


Operator's 
console 


(none) 


Device from which ELLA reads commands (and 
to which it prints diagnostic messages. ) 


List 
output 


M:LO 


Line 
printer 


Line 
printer 


SET, LIST, LP 


Device to which ELLA lists error log data, com- 
mands received, and diagnostic messages. 


Operator's 
console 


SET, LIST, KP 


Device to which ELLA lists error log data and 
diagnostic messages. (Using the operator's con- 
sole for lengthy output is not recommended.) 



INTERRUPTING ELLA EXECUTION 

On-line ELLA execution may be interrupted at any time by 
use of the BREAK key on the user's terminal. This causes 
ELLA to terminate its current activity and to prompt for a 
new command. 

When ELLA is initiated as a ghost job or a batch job, ex- 
ecution may be interrupted through use of the operator INT 
key-in. The effect upon a ghost Job is similar to that of the 
BREAK function on-line. The effect upon a batch job is to 
cause the next command to be read from the card reader. 



SLIS produces a sorted listing of qualified error log 

entries. 

SUM produces a categorized summary of qualified 
error log entries. 

DISP produces a summary of qualified error log en- 
tries in graphic form. 

END terminates ELLA. 



ELLA COMMANDS 

ELLA accepts three types of commands: boundary commands, 
task commands, and the device assignment command (SET, 
described previously). Boundary commands establish or 
change the limits that are to be applied to all subsequent 
task commons; i.e., boundary commands allow the user to 
specify the types of errors in which he is interested. Task 
commands initiate the execution of a particular type of list- 
ing. The device assignment command is used to change the 
listing and message output device during execution of ELLA. 



Note that error log entries are displayed only if they qualify. 
To qualify for inclusion in a display, an error log entry 
must pass aM boundary tests in force at the time the display 
is generated. If no boundary commands have been entered, 
all error log entries qualify. Those error log entries which 
fail to pass one or more of the boundary tests are ignored. 
(Boundary commands are described following the task 
commands. ) 



CLIS The CLIS command requests a chronological list- 

ing of the error entries in the order in which they appear in 
the error file. 



TASK COMMANDS 

Task commands are used to request the ELLA displays and to 
terminate ELLA. ELLA task commands are: 

CLIS produces a chronological listing of qualified 
error log entries. 



The format of the CLIS command is 



C[LIS] 



An example of a CLIS listing is given in Example 3. Table 32 
lists the error log entry headings printed by ELLA and notes 
the manner in which all values are printed. 
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Example 3. Use of the CLIS Command 



In this example, the user chose to initiate ELLA on-line. The user did not desire a lengthy listing at his terminal. 
Therefore he reassigned the listing function to the line printer using the SET command. 

JELLA© 
*SET,LIST,LP© 
*CLIS © 
*END© 
JPRINT© 

After the CLIS command was issued, ELLA produced the chronological listing and then prompted for another command. 
The user desired no further listings, so he terminated ELLA with the END command. He then issued the system PRINT 
command which caused the listing to be output to the printer. The output that was sent to the line printer is shown 
below: 



♦CLIS 



CHRONOLOGICAL LISTING 



FROM 00/00/00 00:00:00:000 
TO 12/31/99 23:59:59:999 



*** SYSTEM IDENTIFICATION *** 

CORE 
TIME (K) SITE I.D. 

11:36:00:000 00128 PRT101 



*** CONFIGURATION *** 







-OPTIONS — 


TIME 


SYSTEM 


CPU 


SYMB RT RB 


RES 


CP-V COO 


S67 


Y N N 


02 







I/O 


ADRS 


DCT 


TIME 


MDL 


PRIM 


ALTN 


INDEX 


11:36:00:000 


7012 


0001 


0001 


01 




7140 


0003 


0003 


02 




7160 


0004 


0004 


03 




7445 


0002 


0002 


04 




7212 


01F0 


01F0 


05 


11:36:00:000 


7322 


0080 


0080 


06 




7322 


0081 


0031 


07 


^ 


7271 


00E0 


00E0 


03 




7271 


00E1 


00E1 


09 




7271 


00E2 


00E2 


0A 


11 :36:00:000 


7271 


00E3 


00E3 


0B 




7611 


0010 


0010 


0C 



*** TIME STAMP *** DATE=07/10/74 TIME=1 2 :00 :00 :004 



*** SIO FAILURE *** 







I/O 


SIO- 


TDV- 


SUBC 


TDV CUR 


REM 




TIME 


MDL 


ADRS 


STAT CC 


STAT CC 


STAT 


COMM DA 


BYTES 


MFI 


12:36:30:782 


7323 


0083 


2000 6 


1000 6 


00 


0011B7 


0001 


00 


12:37:29:518 


7323 


0083 


2000 6 


1000 6 


00 


0011B7 


0001 


00 


12:40:10:398 


7323 


0083 


2000 6 


1000 6 


00 


0011B7 


0001 


00 
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*** TIME STAMP *** DATE=07/10/74 TIME=1 3 :00 :00 : 005 
*** TIME STAMP *** DATE=0 7/1 0/74 TIME=14 : 00 :00 : 00 3 



***SYMBIONT INCONSISTENCY*** 

DCT REL. SY.MB. 
TIME INDEX SECT. DCT 

14:03:13:648 09 0110 02 



*** TIME STAMP *** 
*** TIME STAMP *** 



DATE=0 7/1 0/74 TIME=1 5 :00 :00 :004 
DATE=0 7/1 0/74 TIME=1 6 :00 :00 :00 6 



Note that the CLIS command is listed in the line printer listing and that the existing time boundaries are printed after 
the title. If other boundaries were in force, they too would have appeared. Certain values, such as core size and 
recovery count, are printed in decimal for convenience. Other fields, such as the OPTIONS field, contain flags. 
The true condition is represented by the letter Y, the false condition by the letter N. In this example, the system 
has symbiont capability but does not have remote processing and real-time facilities. 



Table 32. Error Log Entry Headings 



Heading 


Description 


ACCOUNT 
eeeeeeee 


The account (eeeeeeee) in which the faulty file resides. 


---AIO- 
STAT CC 
xxxx X 


A hexadecimal number (xxxx) representing the AIO device and 
operational status bytes (STAT) and a hexadecimal value (x) 
representing the condition code (CC) returned as the result of the 
AIO instruction. 


CL 

XX 


A hexadecimal value (xx) representing the cluster protion of the 
unit address. 


CONTRLR 
f 


A flag (f) indicating whether or not the controller is partitioned in 
addition to the device. Y means the controller is partitioned; N 
means it is not partitioned. 


CORE 

(K) 

dddd 


Core size in decimal thousands (dddd). 


COUNT 
dddd 


The number of entries (in decimal) that duplicate the previous entry. 


CPU 
ddd 


CPU type (ddd). 


CUR COMM DW— 

1 2 
XXXXXXXX xxxxxxxx 


Two hexadecimal numbers (xxxxxxxx) representing the command 
doubleword currently being processed for a device. 


DATE 
mm/dd/yy 


The month (mm), day (dd), and year (yy) that the error log entry 
occurred. 


DCT 
INDEX 

XX 


A hexadecimal value (xx) indicating the order in which the device is 
configured into the system at SYSGEN. The index value for the first 
device is 1. 
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Table 32. Error Log Entry Headings (cont. ) 



Heading 


Description 


ENTRIES 

LOST 

dddd 


A decimal value (dddd) representing the number of error log records 
lost when logging became temporarily impossible for any reason. 


ENTRY 
COUNT 
dddd 


A decimal value (dddd) representing the number of entries in the 
enqueue table belonging to the specified user at the time the error 
log entry was made. 


ERROR 

CODE 

xxxx 


A hexadecimal value (xxxx) giving the error type code for the failure. 
See Appendix B, "Monitor Error Messages" in the CP-V/BP Reference 
Manual, 90 17 64, for error code definitions. 


ERRLOG— 
CALL ADRS 
xxxxxxxx 


A hexadecimal value (xxxxxxxx) representing the caller's address to 
which the error logging routine will return when logging is completed. 
This is used in isolating software faults. 


FILE NAME 


The name of the file in which a fault has been detected. 


-— HIO- 
STAT CC 
xxxx x 


A hexadecimal value (xxxx) representing the status (STAT) and a 
hexadecimal value (x) representing the condition codes (CC) re- 
turned in response to an HIO instruction. 


— INDEX- 
BAD ENTRY 
xxxxxxxx 


The hexadecimal offset (xxxxxxxx) into a 64-word block in ERRFILE 
that locates the first word of the incorrect entry. 


I/O 

ADRS 

xxxx 


A hexadecimal value (xxxx) representing the physical I/O address. 


I/O 
COUNT 
dddddddddd 


A decimal value (dddddddddd) representing the number of SIO 
instruction executed for a device. This value is reset at system 
boot time. 


I/O ADRS 
PRIM ALTN 
xxxx xxxx 


A hexadecimal value (xxxx) representing the primary I/O address 
(PRIM) by which a device can be referenced, and another hexa- 
decimal value (xxxx) representing the alternate address (ALTN) for 
dual access devices. 


-I/0-- 
STAT CC 

XXXX X 


A hexadecimal value (xxxx) representing the status (STAT) and a 
hexadecimal value (x) representing the condition codes (CC) re- 
turned in response to an I/O instruction. 


LOCATIONS 

XXXXXXXX 

xxxxxxxx 


One to fourteen hexadecimal values indicating the addresses of the 
first fourteen (or less) memory locations exhibiting parity errors. 


--MEMORY STATUS — 

1 2 
xxxxxxxx xxxxxxxx 


Two hexadecimal values (xxxxxxxx) representing the status returned 
in response to an LMS instruction. 


---MEMORY STATUS WORDS 

12 3 
xxxxxxxx xxxxxxxx xxxxxxxx 


Three hexadecimal values (xxxxxxxx) representing status returned in 
response to an LMS instruction. 


MDL 
dddd 


A decimal number (dddd) that uniquely identifies peripheral devices 
by the Xerox model number (defined at SYSGEN). 
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Table 32. Error Log Entry Headings (cont. ) 



Heading 


Description 


MFI 

XX 


A hexadecimal value (xx) representing the current state of the 
memory fault indicators returned by the hardware in response to an 
RD instruction. All memory fault indicators will be reset. (Sigma 6 
and 7 only. ) 


MODE 
d 


A decimal value (d) encoding the mode in which the file was opened 
where: 1 - IN; 2 - OUT; 4- INOUT; 8 - OUTIN. 


- -OPTIONS -- 

SYMB RT RB 

f f f 


Indicates whether or not the following facilities are available in the 
system: symbiont routines (SYMB), real-time processing (RT), and 
remote processing (RB). The flag (f) is equal to Y (present) or N 
(absent). 


ORG 
d 


A single decimal digit that indicates the file organization where: 
1 - consecutive; 2 - keyed; 3 - random. 


PAR 
ERRS 

XXXX 


A hexadecimal value (xxxx) representing the number of memory 
locations exhibiting parity errors after a memory scan. 


--POLL- 
STAT CC 

XXXX X 


A hexadecimal value (xxxx) representing the processor fault status 
(STAT) and a hexadecimal value (x) representing the condition 
codes (CC) returned by the hardware in response to a POLP or 
POLR instruction. 


POLR 
RESULTS 

XXXX 


A hexadecimal value (xxxx) representing the processor fault status 
as returned by the hardware in response to a POLR instruction. 


PSDW 

1 2 

XXXXXXXX XXXXXXXX 


Two hexadecimal numbers (xxxxxxxx) representing the contents of 
the program status doubleword. 


REAL 
ADRS 

XXXXXXXX 


A hexadecimal value (xxxxxxxx) representing the actual memory 
address. In an unmapped system, this is the same as the IA field 
of the PSD. 


RECOV 
COUNT 

XX 


Not currently available. Output will appear as zero (00). 


REL. 
SECT. 

XXXX 


A hexadecimal value (xxxx) representing the relative sector at 
which the inconsistency was detected. 


RELATIVE - 
SECT.ADRS 

XXXX 


A hexadecimal value (xxxx) representing the relative sector number 
at which the inconsistency was detected. A relative sector is 256 
words long with each sector on a given device being numbered from 
zero through device end. CP-V maintains file pointers by relative 
sector number to expedite addressing different devices. 


REM 
BYTES 

XXXX 


A hexadecimal value (xxxx) representing the remaining byte count 
as returned in response to a TDV instruction. 
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Table 32. Error Log Entry Headings (cont. ) 



Heading 


Description 


-RETRY- 

REQ REM 

dd dd 


A two digit decimal number (dd) representing the maximum number of 
retries (REQ) after which a device error is returned to requester (value 
obtained from requester's DCB), and another two-digit value (dd) 
representing retry request minus the number of entries attempted (REM). 
The range is between retry request and 0. A value indicates the 
operation was terminated due to retry count rundown. 


SCREECH 
CODE 

XX 


Not currently available. Output will appear as zero (00). 


SEEK ADRS 

XXXXXXXX 


A hexadecimal value (xxxxxxxx) representing the physical disk 
address last used to access this device. 


-- SENSE INFORMATION - 

XXXXXXXX XXXXXXXX XXXXXXXX XXXXXXXX 


A hexadecimal value (xxxxxxxx) representing the diagnostic infor- 
mation returned from the device as a result of sending a "sense" order 
to the device. The value has a 4-word maximum, depending on the 
device. 


— -SIO- 
STAT CC 

XXXX X 


A hexadecimal value (xxxx) representing the status (STAT) returned 
in response to an SIO instruction, and another hexadecimal value 
(x) representing the condition codes (CC) returned. 


SITE I.D. 
eeeeeeee 


An EBCDIC value (eeeeeeee) identifying the site (specified at 
SYSGEN). 


START 
TYPE 

XX 


A hexadecimal value (xx) indicating the degree of initialization 
(always equals three for system device boot). 


SUB 
CODE 

XX 


Not currently available. Output will appear as zero (00). 


SUBC 
STAT 

XX 


A hexadecimal value (xx) representing the status (STAT) of the I/O 
subchannel received as a result of a TDV instruction. 


SUBTYPE 

XX 


A hexadecimal value (xx) indicating the type of copy error that 
occurred. Type 01 indicates read error; i.e., the ghost ERRrFIL re- 
ceived an error indication when reading the original error file. 
Type 02 indicates read error end, meaning that subsequent error log 
entries were correctly read from the original error file. Type 03 indi- 
cates a length error; i.e., the original error file record length was 
incorrect. Type 05 indicates incorrect time; i.e., the time of the 
following entry is either out of range or goes backward. Type 06 
indicates illegal entry type; i.e., the type code of the following 
entry was found to be illegal by the ghost ERRrFIL. 


SYMB. 
DCT 

XX 


A hexadecimal value (xx) representing the order in which the sym- 
biont device is configured into the system; i.e., the DCT index of 
the symbiont device. 


SYSTEM 
CP-V eee 


Displays the operating system name (CP-V) and three EBCDIC char- 
acters (eee) representing the system version specified at SYSGEN. 


TDV CUR 
COMM DA 

XXXXXX 


A hexadecimal value (xxxxxx) representing the current command 
doubleword address returned in response to a TDV instruction. 
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Table 32. Error Log Entry Headings (cont. ) 



Heading 


Description 


---TDV- 
STAT CC 

XXXX XX 


A hexadecimal value (xxxx) representing the status (STAT), and a 
hexadecimal value (x) representing the condition codes (CC) returned 
in response to a TDV instruction. 


TIME 

hh :mm:ss :nnn 


The time the error occurred, in hours (hh), minutes (mm), seconds (ss), 
and milliseconds (nnn). 


TIME LAST 
DUPLICATE 
hh :mm:ss :nnn 


The time in hours, minutes, seconds, and milliseconds at which the 
last duplicate of the preceding entry occurred. 


TIME LAST 
LOST ENTRY 
hh :mm:ss :nnn 


The time of occurrance when the last entry was lost in hours, min- 
utes, seconds and milliseconds. 


TIME 

RES 

dd 


A decimal value (dd) in milliseconds representing the resolution of 
the time field of all error log entries; e.g., if the time resolution is 
2, then the time value for all error log entries is accurate to two 
milliseconds. 


— TIO- 
STAT CC 

XXXX X 


A hexadecimal value (xxxx) representing the status (STAT) and a 
hexadecimal value (x) representing the condition codes (CC) returned 
in response to a TIO instruction. 


- -TRAPPED -- 
INSTRUCT CC 

XXXXXXXX X 


A hexadecimal value (xxxxxxxx) representing the contents of the 
location pointed to by the trapped instruction's address (INSTRUCT) 
in the PSD, and another hexadecimal value (x) representing the trap 
condition codes (CC). 


TRAPPED 

INSTRUCT CC EFF.ADRS 

XXXXXXXX X XXXXXXXX 


A hexadecimal value (xxxxxxxx) representing the contents of the 
location pointed to by the trapped instruction's address (INSTRUCT) 
in the PSD; a hexadecimal value (x) representing the trap condition 
codes (CC); and another hexadecimal value (xxxxxxxx) representing 
the final address (EFF.ADRS) computed for the trapped instruction. 


UN 

XX 


A hexadecimal value (xx) representing the unit portion of the Xerox 
560 unit address. 


UNIT 
NAME 
eeee 


A two-to-four EBCDIC character mnemonic name identifying one of 
the following: CPU; MI (Memory Interface); PI (Processor Interface); 
MIOP (Multiplexed Input Output Processor); RMP (Rotating Memory 
Processor); CT (Communication Terminator); SU (System Unit). 


USER 
I.D. 

XXXX 


A hexadecimal value (xxxx) which is a unique number assigned by 
the system to the particular job or session. 


USER 
NO. 

XX 


A hexadecimal value (xx) representing the index into internal system 
tables used to access user-specific information. 


VOLUME 
SERIAL 
eeeeee 


Not currently available. Output will be blank. 


message 


An operator message of up to 56 alphabetical characters. 
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SLIS A sorted listing is requested with the SLIS 

command. The command has the form 



SLIS 



As in the chronological listing, the sorted listing includes 
all qualified error log entries. In this listing, however, 
entries are ordered by their type, and if they are peripheral 
class errors, by their model number and I/O address also. 

Error records are first categorized by ELLA as system, pe- 
ripheral or secondary records, (see Table 33). System records 
and their associated secondaries are listed first. Except for 
the system ID record and configuration record (which are 
printed in front of all other records), system records are 
listed in ascending type code order as given in Table 33. 
Secondary records are printed following their associated 
primary records. 

Peripheral class records are sorted in three phases. They are 
first separated by model number and printed in ascending 
model number order. All peripheral records with the same 
model number are then separated and listed in ascending 



device address order. Finally, all the records containing 
both the same device address and the same model number are 
printed in ascending type code order. Any secondary rec- 
ords associated with peripheral class entries are printed 
following the associated peripheral records. 

Any secondary record that appears in the error file that can- 
not be linked with a primary record through the above rules 
association will be printed after all peripheral records and 
their associated secondaries under the heading 

>»UNASSOCIATED SECOND ARIES<« 

Each time a record is listed that has a different device 
address than that of the preceding record listed, a model 
Number/Address heading is produced under the heading 

>»MODEL NO. :xxxx I/O ADDRESS; xxxx 

where MODEL NO. is the 4— digit Xerox model number 
designation of the device and I/O ADDRESS is the 4-digit 
(hexadecimal) I/O address of the device. 

An example of a sorted listing is given in Example 4. 



Table 33. Error Log Entry Types 



Name 


Type 
Code 


Description 


System Class 


COPY ERROR 


10 


Recorded as a result of several possible error conditions in 
the error logging mechanism. If the record subtype is 03, 
05, or 06, the record is followed by the 64-word buffer 
in which the error occurred. 


PARITY ERROR 


17 


Recorded when program execution is interrupted to loca- 
tion X , 56 l (MFI) on Sigma 6 or 7 or is trapped to location 
X^C (parity trap) on Sigma 9 or Xerox 560. 


SYSTEM STARTUP 


18 


Recorded when the system is booted and at each recovery. 


WATCHDOG TIMER 


19 


Recorded when program execution traps to location X'46! 
due to a watchdog timer run-out condition. 


FILE INCONSISTENCY 
ENTRY 


1A 


Recorded when the operating system cannot access a file 
in the file management system. The code displayed is 
described in the CP-V/BP Reference Manual, 90 17 64. 


SOFTWARE DETECTED 
SYMBIONT INCONSISTENCY 


IB 


Recorded when the operating system cannot access a 
symbiont file in the symbiont file management system. 


INSTRUCTION EXCEPTION 


ID 


Recorded when program execution traps to location X , 4D I 
on Sigma 9 or Xerox 560 due to an instruction exception 
condition. 


LOST ENTRY INDICATOR 


IE 


Recorded when error log buffering constraints, timing 
considerations, and error detection rates force error log- 
ging to be temporarily suspended or otherwise impossible. 



Error Log Listing Processor 71 



Table 33. Error Log Entry Types (cont. ) 



Name 


Type 
Code 


Description 


System Class (cont. ) 


POWER ON 


20 


Recorded when the hardware power monitor forces 
program execution to trap to location X'51 1 as a result 
of detecting a restoration of power condition. This 
normally occurs as a result of a power outage of 500 
milliseconds or more in duration. 


CONFIGURATION 


21 


Recorded when ERRFILE is entered. 


SYSTEM IDENTIFICATION 


22 


Recorded when ERRFILE is entered. 


TIME STAMP 


23 


The date and time recorded when ERRFILE is entered in 
the system and every hour on the hour. 


BAD GRANULE RELEASE 


24 


Recorded when either a bad disk address has been de- 
tected or when the granule to be released is already free 
(dual allocation). 


REMOTE PROCESSING 
ERROR RECORD 


26 


Recorded when an error is detected in the transmission of 
data to or from a remote processing workstation. 


OPERATOR MESSAGE 


27 


A message entered by the operator through use of the 
ERSEND key-in. 


PROCESSOR FAULT INTERRUPT 


30 


Recorded when there is a processor fault interrupt 
(location X'56') on the Xerox 560. 


MEMORY FAULT INTERRUPT 


31 


Recorded when there is a memory fault interrupt (loca- 
tion X'57 l ) on Sigma 9 or Xerox 560. 


PROCESSOR CONFIGURATION 


41 


Recorded when the system is booted. 


ENQUEUE TABLE OVERFLOW 


50 


Recorded to log specific information after the operating 
system has detected an enqueue table overflow condition. 


UNKNOWN TYPE = xx 


XX 


An unknown type code xx has been encountered in an 
error log entry. 


Peripheral Class 


SIO FAILURE 


11 


Recorded when the condition codes returned by the SIO 
instruction are such that either CO or CC2 are true. 


DEVICE TIMEOUT 


12 


Recorded when the time-out value specified by DCT1 1 
has been exceeded. 


UNEXP. INTERRUPT 


13 


Recorded when no match can be found between the I/O 
address return in the status register by the AIO instruction 
and any DCT1 I/O address of a device known to be busy. 
AIO CC= llxx will not be logged. 


DEVICE ERROR 


15 


Recorded when an I/O request is not successful upon one 
of the specified number of retries. (It may or may not 
have eventually been successful. ) Only the status of the 
last erroneous retry for a given request is logged; not all 
of the retries. 
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Table 33. Error Log Entry Types (conr. ) 



Name 


Type 
Code 


Description 


Peripheral Class (conr. ) 


PARTITIONED RESOURCE 


51 


Recorded when a resource has been partitioned from the 
system. 


RETURNED RESOURCE 


52 


Recorded when a previously partitioned resource has been 
returned to the system. 


Secondary Data Class 


DEVICE ERROR 
SECONDARY 


16 


Recorded when nonzero sense data is available following 
a device error. 


DUPLICATE ENTRIES 


IF 


Recorded when the error logging mechanism detects 
identical consecutive errors. This prevents the error log 
from becoming saturated with redundant information. 


SECONDARY POLL 
RECORD 


32 


Recorded for each nonzero poll status received by the 
processor polling routines. 


MEMORY PARITY 
SECONDARY 


42 


Recorded for each memory unit that has recorded an error as 
determined by the memory polling routines (i.e., bits 22- 
31 of status word zero are nonzero) for Xerox 560. 


MEMORY PARITY 
SECONDARY 


43 


Recorded for each memory unit that has recorded an error as 
determined by the memory polling routines (i.e., bits 22- 
31 of status word zero are nonzero) for Sigma 9. 


MEMORY PARITY 
SECONDARY 


44 


Recorded to log specific information obtained by scan- 
ning memory to attempt to isolate locations which cannot 
sustain correct parity. 



Example 4. Use of the SLIS Command 



For this example, the following batch fob deck was submitted. 



iFIN 



END 



SLIS 



I ELLA 



!JOB,FEOPER, SITE 102, E 



In the resultant sorted listing below, all related entries are grouped together. This facilitates the scanning of the 
error log that is necessary in order to determine the common characteristics of related failures that have occurred 
over a period of time. 
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Note the OPERATOR MESSAGE entry in the listing. Such messages can be entered into the error log at the 
operator's console by means of the ERSEND key-in. (See the CP-V/OPS Reference Manual, 90 16 75. ) 



♦SLIS 



SORTED LISTING 



FROM 07/10/74 12:00:00:000 
TO 12/31/99 23:59:59:999 



+** PILE INCONSISTENCY ♦♦♦ 

DCT 
TIME ACCOUNT INDEX 

16:03:13:6U8 771731 09 
16:42:32:197 771731 09 



RELATIVE 






ERROR 


SECT ADRS 


MODE 


ORG 


CODE 


0110 


01 


02 


757F 


0110 


01 


02 


757F 



FILE NAME 

RTRTEXT:V113 
RTRTEXT:V113 



♦*♦ TIME STAMP *♦+ 
*** TIME STAMP *** 
♦♦♦ TIME STAMP ♦♦♦ 
♦♦♦ TIME STAMP ♦♦♦ 
♦♦♦ TIME STAMP *** 



DATE=07/10/74 
DATE=07/10/74 
DATE-07/10/74 
DATE=0 7/1 0/74 
DATE=07/10/74 



TIME=12:00:00:004 
TIME=13:00:00:004 
TIME=14:00:00:004 
TIME=15:00:00:004 
TIME=16:00:00:006 



SUBC 


TDV CUR 


REM 




STAT 


COMM DA 


BYTES 


MFI 


00 


001179 


004C 


00 


00 


001179 


004C 


00 



TDV- 


TDV CUR 


REM 


I/O 


STAT CC 


COMM DA 


BYTES 


MFI COUNT 


2042 2 


00118B 


0000 


00 0000000984 



♦♦♦OPERATOR MESSAGE**^ TIME = 14:22:03:782 
9TA81 CAPSTAN DRIVE NOISY (JDR) 



MODEL NO: 71 60 I/O ADDRESS: 0004 



♦♦♦ SIO FAILURE *♦♦ 

SIO- TDV- 

TIME STAT CC STAT CC 

07:02:28:922 2A42 6 2042 6 

15:05:21:166 2A42 6 2042 6 



♦♦♦ DEVICE ERROR ♦♦♦ 

AIO- TIO- 

TIME STAT CC STAT CC 

15:09:20:862 0048 6 1842 



,,, MODEL NO:7271 I/O ADDRESS :00E0 ... 

♦♦♦ DEVICE ERROR ♦♦♦ 

AIO- TIO- TDV- TDV CUR REM 

TIME STAT CC STAT CC STAT CC COMM DA BYTES 

12:56:21:278 0458 6 1842 0442 2 0011C7 0000 

15:42:55:694 0458 6 1842 0442 2 0OOA7E 0000 

15:42:55:906 0458 6 1842 0442 2 000A7E 0000 

. . . DEVICE ERROR SECONDARY 
I/O 

TIME ADRS SENSE INFORMATION 

12:56:21:284 00E0 00F90A02 0305F500 OOCAO000 00000000 
15:42:55:700 00E0 00E70500 0119FA02 80CA0000 00000000 
15:42:55:910 00E0 00E70500 0119FA0E 03E20000 00000000 



CUR COMM DW RETRY- VOLUME SUBC 

1 2 REQ REM SERIAL STAT SEEK ADRS 
09008C70 2E000078 03 03 00 0000000B 



I/O 
MFI COUNT 
00 0000089148 
00 0000138032 
00 0000138036 



CUR COMM DW — 

1 2 
02031800 1E000800 
02075800 1E000570 
02075800 1E000570 



-RETRY- VOLUME SUBC 

REQ REM SERIAL STAT SEEK ADRS 
03 03 00 00F90A00 
08 08 00 00E70404 
08 07 00 00E70404 
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SUM The SUM command requests a summary of the 

contents of the error file which lists the total number (in 
decimal) of qualified error log entries for each error type. 
The command has the form 

SU[M] 

In addition to error totals, the summary contains an I/O 
activity count for each device that has errors recorded. IO 



ACTIVITY is the count of all SIOs issued to a given device 
for the time period covered by the summary. 

Unlike other listings produced by ELLA, logical device 
addresses are used in the summary rather than physical ad- 
dresses. For example, a device CRA03 would appear as 
A03 and a device DCBFO would appear as BFO. 

Example 5 provides an example of the SUM command. 



Example 5. Use of the SUM Command 



SELLA© 

*SUM© 














ERROR S U 


M M 


A 


R Y 








FROM 07/10/74 
TO 12/31/99 


00 
23 


:00 
:59 


:00: 
:59: 


000 
999 






SYSTEM ERRORS 














TYPE 

SYSTEM STARTUP 

CONFIGURATION 

SYSTEM I.D. 

TIME STAMP 

FILE INCONSISTENCY 




ERRORS 
1 
6 
1 
16 
2 






DEVICE ERRORS 














IO SIO 
MDL ADRS FAIL 
7140 A03 
7160 A04 

7322 A80 

7323 A83 3 
7323 A84 
7323 A85 
7271 AEO 
7232 BFO 


UNEXP 
INTRPT 










DEV 

ERROR 
13 
6 
78 
3 
4 
6 
3 
2 


DEV 
TIMEOUT 


















IO 

ACTIVITY 
0000014798 
0000004906 
0000227574 
0000018295 
0000021926 

0000161268 
0000248749 


TOTAL ERRORS: 


00144 











DISP The DISP command requests a graphical display 

of error log entries. The DISP command has the form 

DI[SP][, interval] 

where interval specifies the time interval, in minutes, to be 
used for the graph. The interval specified may range from 1 
to 60. The default interval is ten minutes. 

The graph produced by the DISP command is a bar graph. 
Each line begins with the end time of the interval, followed 
by the 2— digit - error type code of each error recorded during 



the interval. If the number of errors for a given interval 
exceeds 30, then only the first 30 error type codes are 
printed, and FF is printed at the end of the line. 

Only qualified error log entries are included. Time Stamp, 
Configuration, and ID entries are always excluded. 

The first and last lines in the graph are the first and last 
intervals within the TIME boundary that contains qualified 
error log entries. The actual time period scanned is printed 
at the beginning of the listing. 

An example of a graphic display is given in Example 6. 



Error Log Listing Processor 75 



Example 6. Use of D ISP Command 



The user in Example 5 continues as follows: 

*DISP,45© 

GRAPHIC DISPLAY 



FROM 00/00/00 00:00:00:000 
TO 12/31/99 23:59:59:999 



THE ERROR 


-10 


03 


:56 15 


OH 


:41 


1A1A 




05 


:26 






06 


:11 






06 


:56 






07 


:41 


15161515161615111516 


03 


:26 


1B11 1215151 11515 




09 


:11 


15 




09 


:56 






10 


:41 






11 


:26 






12 


:11 


2715 




END OF FILE 








The distribution of errors over the scanned time period is more readily apparent in this display than in the other forms 
of error listings. This display is used to check for patterns and trends in error occurrences. The digits that form this 
bar graph are in pairs, (e.g., the line 1 Bl 1 12151511 1515 contains eight digit pairs). Each digit pair represents one 
error and the two digits are the type code of the error. 



END The END command terminates ELLA and exits to 

the monitor. The format of the command is 

E[ND] 

BOUNDARY COMMANDS 

The boundary commands are used to select specified portions 
of the error file for display. In order for an error record to 
be accepted for display, it must satisfy each boundary. 
There are four boundaries: 

• Time 

• Model number 

• Device address 

• Error type code 

An error log entry will be listed by a subsequent task com- 
mand if it was recorded within the time limits specified by 



the TIME command and if it has one of the error type codes 
specified by the TYPE command. If the entry is a peripheral 
class entry (see Table 33), it must also have a model number 
field and an address field which agrees with one of the model 
numbers and one of the device addresses specified by the 
MOD and DEV commands respectively. 

It is not necessary, however, to use any of the boundary 
commands. If a boundary command is not used or a boundary 
has been reset, all error log entries are considered to have 
met the conditions of display for that boundary. 

Boundary commands, if judiciously used, can be especially 
helpful in minimizing ELLA output when the output listing 
function has been assigned to a slow speed device such as an 
on-line terminal. 

RSET The RSET command resets all boundary parameters 

to their default values. (The default values are given in the 
subsequent boundary command descriptions. ) The RSET com- 
mand has the form 

R[SET] 
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TIME The TIME command sets both date and time 

boundaries. Error log entries are displayed only if they 
occurred between the begin date and time and the end date 
and time. The TIME command has the form 

Tl[ME][,begin][-end] 

where begin and end have the form 

[month/day/yearj[, hourrminute] 
or 

[hour:minute][, month/day/year] 

where 

month = 1-12 

day = 1-31 

year = 01-99 

hour = 00-23 (24 hour clock) 

minute = 00-59 



If the TIME command is not used (or if time and date are 
reset by the RSET command) ELLA establishes the following 
beginning and ending times: 

begin =■ 00/00/00, 00:00 

end = 12/31/99, one millisecond before midnight. 
(The time is recorded internally in millisecond 
increments. ) 

If only one group (i.e., 'begin' or 'end') is entered under 
the TIME command, the current state of the other group re- 
mains in affect. 

It is not necessary for both fields within a group to be 
entered. If time is the only field entered in a group, then 
the date for that group is the current day by default. Time 
by default is a bit more complex. If the date field is the 
only field entered for 'begin 1 , then 00:00 is the time by de- 
fault. If the date field is the only field entered for 'end' 
then 1 millisecond before midnight is the time by default. 

Examples of the TIME command are given in Example 7. 



Example 7. TIME Command Usage 



The following series demonstrates TIME command usage. Assume all of the TIME entries have been entered consecu- 
tively at the console. 

*TIME, 4/25/73-5/27/73 ® 

The time limits have been set by the entry above as follows: starting time is 00:00 on 4/25/73, and ending time in 
one millisecond before midnight on 5/27/73. The only error log entries that will be displayed by subsequent task 
commands are those that lie between these two time points. 

*TIME, 2:00-10:00© 

The limits have now changed so that the starting time is 2:00 AM on the current day (i.e., the day on which the ELLA 
run is being made), and ending time is 6:00 PM on the current day. (When no date is entered, the current date is 
implied.) 

*TIME, 18:00-10:00© 

This entry is illegal and will produce a diagnostic message because the starting time is later than the ending time. 
The limits 2:00 and 18:00 from the previous entry are still in effect. 

*TIME 00:00© 

Here the starting time has been changed to 00:00 on the current day. Since no ending time has been entered, the 
previous ending time of 18:00 remains in effect. 

*TIME, 1/1/74-12:00© 

This sets the starting limit to 00:00 on 1 January 1974, and the ending limit to noon on the current day. 

*TIME, -13:00© 
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The previously entered starring limits (1/1/74) remair 


i in effect because no starting parameter is 


entered here. 


The 


ending limit is changed to 13:00 for the current day. 












*R5ET © 












ELLA time defaults are reestablished. The default is 


the entire time 


span of the error 


log. 






*TIME, 12:00, 10/15/73-10/16/73, 12:00 © 












Finally, the starting time is set to noon on 10/15/73 


and the ending 


limit to noon on 


10/16/73. 


Note that the order 


of time and date entry is immaterial. 













TYPE the TYPE command allows the user to select 

error log entries for display by specifying an error record 
type code (see Table 33). The TYPE command has the form 



^'Cf,...^]} 



type is a hexadecimal error type code. 

specifies that the default (all types) is to be 
reestablished. 

If error log entry types have been specified via the TYPE 
command, error log entries are displayed only if they have 
a type code equal to one of the types specified. Up to five 
types may be specified for display at one time. 

If the TYPE command is not used, records of all types are 
displayed (including any records that may have illegal type 
codes). Displaying all types is the default condition. Hav- 
ing once used the TYPE command, the default condition 
may be reestablished by entering TYPE, or by using the 
RSET command. 

Each time the TYPE command is used, the previoualy spe- 
cified types are replaced with the newly entered types. 

DEV The DEV command selects error log entries for 

display by specifying up to five I/O addresses. The DEV 
command has the form 



de[v],{: 



.address.[, . . .address,.] 



whe 



address is a 1 to 4— digit hexadecimal physical I/O 
address. (Leading zeros in the address need not be 
specified. ) 

specifies that the default (all devices) is to be 
reestablished. 

Up to five physical I/O addresses may be specified. Each 
time the DEV command is used, the previously specified ad- 
dresses are replaced with the newly entered addresses. 

If this command is not used, records are displayed without 
regard to their associated device address. This is the default 



condition. Having once used the DEV command, the default 
condition may be reestablished by entering DEV, or by 
using the RSET command. 

When particular device addresses have been specified through 
use of the DEV command, error log entries classified as sys- 
tem records (see Table 33) are not displayed, and a peripheral 
class entry is displayed only if the device address field in 
that entry is equal to one of the addresses specified by the 
DEV command. 

MOD The MOD command selects error log entries for 

display by specifying up to five model numbers. When par- 
ticular model numbers have been specified through use of 
the MOD command, error log entries classified as system 
records (see Table 33) are not displayed, and a peripheral 
class entry is displayed only if the model number associated 
with that record is equal to one of the model numbers spe- 
cified by the MOD command. The MOD command has the 
form 



M 
where 



L° D M model .[,... model ]j 



model is a 4— digit model number (e.g., 7446, 7271). 

specifies that the default (all models) is to be 
reestablished. 

Each time the MOD command is used, the previously spe- 
cified model numbers are replaced with the newly entered 
model numbers. 

If this command is not used, records are displayed regardless 
of their associated model number. This is the default con- 
dition. Having once used the MOD command, the default 
condition may be reestablished by entering MOD, or by 
using the RSET command. 

Examples 8 through 12 demonstrate the use of the MOD, 
DEV, and TYPE commands for selecting specific portions of 
ERRFILE for display. The examples are consecutive portions 
of one continuous on-line session. In these examples, the 
user has chosen to display everything at the terminal. This 
means that the user will be able to see the output immedi- 
ately, but the user must make judicious use of this rather 
slow output device. 
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Example 8. Use of the MOD, DEV, and TYPE Commands 



Assume that the user had already requested and received a summary of the error file (which would be a logical first 
step). The user then proceeded to display the operator messages present in the error file. 

*TYPE,27® 
*CLIS © 



CHRONOLOGICAL LISTING 



TYPE =27 

FROM 00/00/00 00:00:00:000 

TO 12/31/99 23:59:59:999 



*** OPERATOR MESSAGE *** 
9TA31 CAPTSTAN NOISY (JBR) 



TIME 



12:33:00:079 



Note that the TYPE parameter is listed at the beginning of the display because TYPE is no longer set to the default. 

Because only one type of error was requested, the terminal is a practical display device. If more than one type of 
error is requested, a slightly different procedure can be used as shown in the next example. 



Example 9. Use of the MOD, DEV, and TYPE Commands 



The user from the previous example next desired to examine some system failures. Note that the new TYPEs entered 
in this example replace the old TYPE entered in the previous example. 

When more than one type of error is requested, a sorted listing often reduces the time required for output. This is due 
to the fact that ELLA only prints headings when a new type of entry is to be listed and SLIS groups all related entries 
together. 

*TYPE,18,1B© 

♦SLIS® 



SORTED LISTING 



TYPE =18 1B 
FROM 00/00/00 
TO 12/31/99 



00:00:00:000 
23:59:59:999 



*** SYSTEM STARTUP *** 







START 


RECOV 


SCREECH 


SUB- 


TIME 


DATE 


TYPE 


COUNT 


CODE 


CODE 


09:32:00:000 


07/10/74 


04 


01 


19 


00 


12:05:00:000 


07/10/74 


01 


01 


00 


00 


17:21:00:000 


07/10/74 


05 


02 


00 


00 



***SYMBIONT INCONSISTENCY*** 

DCT REL. SYMB. 
TIME INDEX SECT. DCT 

11:29:08:406 09 00A0 02 
16:03:13:648 09 0110 02 
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Example 10. Use of the MOD, DEV, and TYPE Commands 



The user proceeded as follows: 



*TYPE, 17© 
5>EV, 1F0© 
*CLIS© 



No output was produced because TYPE 17 and DEV X'lFO' are mutual ly exclusive. Type 17 (Parity Error) is a system 
class error while device X'lFO' implies that peripheral class errors are desired. Entering either MOD or DEV values 
precludes the display of any system errors (only peripheral class errors will have model or device address information, 
and all four boundaries tests -MOD, DEV, TYPE, and TIME —must be passed for an error log entry to be displayed). 



Example 11. Use of the MOD, DEV, and TYPE Commands 



The user next decided to examine SIO failures on several devices. 



♦TYPE ,11© 

♦DEV, 4, 81,82,83© 

+CLIS© 



CHRONOLOGICAL LISTING 



TYPE =11 

DEV =0004 0081 0082 0083 

FROM 00/00/00 00:00:00:000 

TO 12/31/99 23:59:59:999 



♦♦♦ SIO FAILURE ♦♦♦ 







I/O 


SIO- 


TDV- 


SUBC 


TDV CUR 


REM 




TIME 


MDL 


ADRS 


STAT CC 


STAT CC 


STAT 


CO.MM DA 


BYTES 


MFI 


12:36:30:782 


7323 


0083 


2000 6 


1000 6 


00 


001 1B7 


0001 


00 


12:37:29:518 


7323 


0083 


2000 6 


1000 6 


00 


0011B7 


0001 


00 


12:40:10:398 


7323 


0083 


2000 6 


1000 6 


00 


0011B7 


0001 


00 


♦♦BREAK 



















After examining several of the failures on device X'0083', the user realized that no new information would be gained 
by listing the remaining errors. Therefore, the user interrupted the listing process by activating the BREAK key at the 
terminal. 
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Example 12. Use of the MOD, DEV, and TYPE Commands 



Finally, the user summarized, in graphic form, all Model 7322 and 7323 failures that occurred on the current day. 

*DEV,0® 
*TYPE,0© 
*MOD, 7322, 7323© 
♦TIME, 00: 00© 

*DISP© 



GRAPHIC DISPLAY 



MODL =7322 7323 

FROM 02/09/74 00:00:00:000 

TO 12/31/99 23:59:59:999 



TIME ERROR 

0— — 

09:11 11 

09:21 

09:31 

09:41 

09:51 

10:01 

10:11 

10:21 

10:31 

10:41 

10:51 

11:01 

11:11 

11:21 

11:31 

11:41 

11:51 



■10- 



•20- 



-30- 



1516151516161115151616 
1315161516 



12: 

12 

12 

12: 



01 
11 
21 
31 



1516 



END OF FILE 



DSPL The DSPL command displays the current state of 

those ELLA parameters that are alterable by the boundary 
commands. The date and time boundaries are always listed 
by this command. Each of the remaining boundaries will 
also be listed unless its current state is its default state. 

The DSPL output Is printed both on the output listing device 
and the command input device. In batch operation, DSPL 
output is only directed to the output listing device since 
the input device is the card reader. 

The format of the command is 

DS[PL] 

An example of the command is given in Example 13. 



PREDEFINED TASKS 



This section contains a set of predefined tasks that should 
be useful to the person who needs periodic error log reports, 
but has no need for a more precise knowledge of the ELLA 
processor's command structure. These tasks could be main- 
tained as job decks (as illustrated here), or the commands 
might be entered into a file to facilitate on-line submission 
to the batch stream (see the TEL BATCH command in the 
CP-V/TS Reference Manual, 90 09 07). The account from 
which these jobs are run must have a diagnostic privilege 
level (A0 or higher). The tasks are listed in Examples 14 
through 16. 



Error Log Listing Processor 



81 



Example 13. Parameter Display 



The on-line user may check the current state of the ELLA boundaries conveniently with the DSPL command. If the 


listing device has been assigned to a line printer, the boundary information will be displayed on both the line printer 


and the user's terminal. 


*RSET © 


*SET,LIST,LP© 


*DSPL © 


FROM 00/00/00 00:00:00:000 


TO 12/31/99 23:59:59:999 


*TYPE,11,12,15© 


*DEV,E1© 


*DSPL® 


TYPE =11 12 15 


DEV=00E1 


FROM 00/00/00 00:00:00:000 


TO 12/31/99 23:59:59:999 



Example 14. Listing the Entire Error File 



The following deck obtains an error summary and a chronological listing of the entire contents of the error file. 



!FIN 



END 



CLIS 



SUM 



SELLA 



! JOB account, name, priority 
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Example 15. Listing Errors for the Current Day 



The following job deck obtains an error summary, a chronological listing, and a sorted listing of the errors recorded 
by the system on the current day. If error log reports are to be obtained daily, it is recommended that this job be run 
at the end of the processing day. 



!FIN 



END 



SLIS 



CLIS 



SUM 



TIME, 00:00 



SELLA 



! JOB account, name, priority 



Example 16. Listing Start-Ups, Configuration, and Device Partitioning Activity 



The following job deck obtains all the configuration data together with system start-up, partitioned resource, and 
returned resource entries in chronological order. 



!FIN 



END 



CLIS 



TYPE, 18,21,22,51,52 



IELLA 



!JOB account, name, priority 



\ 
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ELLA MESSAGES 



ELLA COMMAND SUMMARY 



Messages output by the ELLA processor are listed in 
Table 34. 



ELLA commands are summarized in Table 35. The left-hand 
side lists the command formats. The right-hand side de- 
scribes the function of the command. 



Table 34. ELLA Messages 



Message 


Meaning 


ABNORMAL ERROR CODE = xx 
SUBCODE = xx 


An abnormal condition was detected in issuing a system CAL. 
The abnormal code and subcode are described in the CP-V/BP 
Reference Manual, 90 17 64, (and the CP-V/TS Reference 
Manual, 90 09 07). See the system analyst. 


BREAK 


The BREAK key was depressed. ELLA stops processing and waits 
for a new command. 


ELLA 708006- A00 


This heading is output when ELLA is first loaded. 


ERRFILE IS BUSY, WILL TRY AGAIN 


ELLA tried to access the error log file and found it busy. 


**ERRLOG NON-EXISTENT 


The ERRFILE file does not exist. See the system analyst. 


ERROR IN KEY FORMAT 

(YEAR/DATE NOT IN PACK DECIMAL) 


An ERRFILE entry had an erroneous key. See the system analyst. 


ERROR IN SYSTEM TIME 


The time in the error log file was not logical. See the system 
analyst. 


ERROR OCCURRED: CODE = xx 
SUBCODE = xx 


An error was detected in issuing a system CAL. The error code 
and subcode are described in the CP-V/BP Reference Manual, 
90 17 64, (and the CP-VAS Reference Manual, 90 09 07). See 
the system analyst. 


ERROR: TIME . GT. 
99:59:59:999 


The time in an error log entry was greater than 99 hours, 59 
minutes, 59 seconds, or 999 milliseconds. See the system analyst. 


ERROR: TOO MANY CHARACTERS OR 
LINES 


ELLA tried to output more than 132 characters to the line printer. 
See the system analyst. 


FILE ASSIGNMENT IS NOT 
IMPLEMENTED YET 


ELLA tried to use the default assignment to ERRFILE and was 
unsuccessful. Assign M:BI to ERRFILE. 


INSUFFICIENT PRIVILEGE LEVEL ABORT 


ELLA requires an A0 or higher privilege level. 


INVALID REQUEST 


The command entered was invalid. 


NON-REASSIGNABLE 


Once the operator's console is assigned as the control device, it 
cannot be reassigned. 


NOTHING IN ERRFILE 


ERRFILE does not contain any records. 


**OVERFLOW OF SORT OR MOD/IO 
TABLES 


ELLA will only support 50 unique L/O addresses. Use the 
boundary commands to restrict the number of I/O addresses. 


UNABLE TO LOAD SEGMENT = nn 


ELLA tried to load overlay number nn and an error was detected. 
See the system analyst. 
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Table 35. ELLA Command Summary 



Format 


Description 


C[LIS] 


Requests a chronological listing of the error entries in the order 
in which they appear in ERRFILE. 


DE[V],{°,. r ., -.1 
laddressJ, . . ., address ,-j ) 


Selects error log entries for display by specifying up to five 
physical device I/O addresses or (if is specified) specifies that 
error log entries for all devices are to be displayed. 


Dl[SP][, interval] 


Requests a graphical display of error log entries. 


DS[PL] 


Displays the current state of the four types of boundaries. 


E[ND] 


Terminates ELLA and exits to the monitor. 


M[OD] ' {model £..., model,.]} 


Selects error log entries for display by specifying up to five model 
numbers or (if is specified) specifies that error log entries for all 
models are to be displayed. 


R[SET] 


Resets all boundary parameters to their default values. 


SET, LIST, {j^} 


Reassigns the listing and message output device assignment during 
execution of ELLA. LP specifies line printer. KP specifies oper- 
ator's console for the ghost and batch modes and on-line terminal 
for the on-line mode. 


SLIS 


Requests a sorted listing of the error log entries. 


SU[M] 


Requests a summary of the contents of the error file which lists 
the total number (in decimal) of qualified error log entries for 
each error type. 


tl[ME][,begin][-end] 


Sets both the date and time boundaries where begin and end have 
the form 

[month/day/year][, hourrminutej 

or 
[hour:minute][, month/day/year] 


TY ^Ce,[,... t ype 5 ]} 


Selects error log entries for display through the specification of 
error record type codes (see Table 33) or (if is specified) 
specifies that all types are to be displayed. 



HARDWARE-ERROR DIAGNOSTIC CALS 



I The following three CALs are intended for use by the monitor 
in performing diagnostic functions relating to the hardware- 
error log and must be issued by a program from the :SYS 
account. They provide the following services: reading from 
the hardware-error log, writing to the hardware-error log, 

| and initiation of diagnostic ghost jobs. 



These three services are all invoked by a CAL1, 6 fpt in- 
struction; the addressed FPT contains a code and a parameter. 
The FPT codes and the functions performed are as follows: 



FPT Code 


1 
6 



Function 

Read Error Log 
Write Error Log 
Initiate Ghost Job 
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The status of the requested operation is reported via 
condition-code settings summarized below. (Not all of the 
status indicated are appropriate to, or reported by, all 
three CALs.) 

CO. CC2 CC3 CC4 Status 

Normal return. 

1 Request denied: insufficient privi- 

lege, not in :SYS account, or buffer 
is not a data page. 

10 Error during operation (Read or 

Write), or job unknown (Initiate). 

10 Last buffer. 

1 Error log does not yet exist (Read). 

In each case, the calling program must be of privilege level 
CO or greater; otherwise CC1 is set to 1 and no action is 
taken. 

READ ERROR LOG 

The format of the FPT for a read-error- log request is 



X'00' 



1 2 314 5 6 7 18 9 10 111 12 13 14 15 



Buffer address 



16 17 18 19120 21 22 23124 25 26 27128 29 30 31 



A variable number of words up to a maximum of 256, de- 
pending upon the contents of the error log, is read to the 
area addressed by the FPT. This is a 'destructive' read, 
returning error- log granules to the monitor's available pool 
as they are exhausted. 

The error-log file is not protected against simultaneous use; 
thus only one program in the entire system should read this 
file. 



WRITE ERROR LOG 

The format of the FPT for a write-error-log request is 



X'OT 



1 2 3 I 4 5 6 7 ! 



1U12 13 14 15 



Buffer address 



16 17 18 19120 21 22 23124 25 26 27 1 28 29 30 31 



The second byte of the data record addressed by the FPT 
must specify the number of words to be written, up to a 
maximum of 253. The first byte of the record should con- 
tain a type code. 



INITIATE GHOST JOB 

The format of the three-word FPT for an initiate-job request 
is 

word 



X'06' 



1 2 3l4 5 6 7 8 9 10 11 1 12 13 14 15l 16 17 18 I9l 20 21 22 23124 25 26 27128 29 30 31 



words 1 and 2 (Name of job to be initiated) 



n 


Q l 


a 2 


a 3 


a o 
n-3 


V2 


a n-l 


a 
n 


1 2 3 1 4 5 6 7 


8 9 10 111 12 13 14 15 


16 17 18 19l20 21 22 23 


24 25 26 27 1 28 29 30 31 



(Name of job must be in TEXTC format.) 

If the program to be initiated is already in execution at the 
time of the request and is not in a waiting state (WAIT CAL 
with unexpired time), the normal return is made (CCI=0). 
If the program is in a waiting state, it will be activated 
immediately at the WAIT CAL plus 1 and a normal return is 
made to the initiating program. 
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7. SHARED PROCESSOR FACILITIES 



INTRODUCTION 

This chapter describes the shared processor facilities of 
CP-V. These facilities permit the sharing of the code for 
compilers, assemblers, command language processors, de- 
buggers, libraries, and other programs among all simulta- 
neous users. 

Shared processors are not limited to programs provided 
by Xerox. The facilities may be effectively used when- 
ever a program has a high probability of common usage. 
Service bureaus, for example, may use the mechanism for 
proprietary packages. Corporate installations may use the 
mechanism for programs with a high use frequency. 

Most programs may be established as shared processors by 
naming them at SYSGEN time. This causes the file copy 
of the program from the :SYS account to be written on the 
swapping disk during system initialization. The program is 
then available through high-speed swapping I/O. 

The file copy of the program is retained for recovery pur- 
poses and may be copied to another account and run as an 
unshared program under Delta for development and debug- 
ging purposes. If the load module in the :SYS account is 
replaced, the shared copy of the program on the swapping 
disk is updated to the newer version in the event of a sys- 
tem recovery. 

To qualify as a shared processor, a program must meet cer- 
tain requirements. These requirements are outlined in the 
remainder of this chapter. The most stringent requirement 
relates to the single overlay level that is described in the 
section below titled "Overlay Restrictions". 



PUBLIC PROGRAMS 

A program whose load module is in the :SYS account is a 
public program in the sense that it may be called either by 
a control card containing the ! symbol and the program 
name, or by an entry of the program name in response to a 
TEL prompt (!) for commands. Each user of a public pro- 
gram has his own copy of the program. 



SHARED PROGRAMS 

Shared programs are called in the same manner as public 
programs. However, each user of a shared program has his 
own copy of only the data and DCB portion of that program; 
the procedure portion is shared by all users associated with 
the shared program. 

There are four distinct kinds of shared programs: 

1. Ordinary shared processors. 

2. Special shared processors. 

3. Shared debuggers. 

4. Public libraries. 

All shared processors must be built by the batch loader. 
Ordinary shared processors occupy the same virtual memory 
as user programs and may not be associated with them. 

Special shared processors, shared debuggers and public li- 
braries occupy (and are overlayed in) the special processor 
area. Figure 11 shows the virtual memory allocation for 
shared programs that are biased within the special processor 
area. Shared debuggers may be associated only with user 
programs; they may not be associated with any other shared 
processors. Public libraries may be associated with user 
programs or ordinary shared processors; a public library may 
not be associated with a special shared processor. Note 
that both a shared debugger and a core library may be con- 
currently associated with a user program. This is possible 
because the procedure portion of the debugger and the 
library may be overlayed in the special processor area. 



LOG-ON CONNECTION 

Commonly used programs, such as BASIC, may be called 
automatically by LOGON. The name of the program to 
be called, which may be either a shared or public program 






K 32 


!K 4C 


)K 11 


2K 


12 


3K 




Monitor 
area 


Context 
area 


Available area 


Special processor area 


(User program or dynamic data) 


Data 
(if any) 


DCBs 
(if any) 


Procedure 






- 









Figure 11. Special Processors — Virtual Memory 
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from any accessible account, is established in the user's 
log-on record by Super. LOGON calls the named program 
for the user following a successful log-on. 



SHARED PROCESSOR PROGRAMMING 

The programming of shared processors may require certain 
information about the CP-V monitor. This information is 
outlined below. 



FIXED MONITOR LOCATIONS 

For certain purposes, such as the choice of an effective core 
allocation technique, it is desirable for processors and other 
programs to be able to identify the monitor in operation, 
certain critical locations of the monitor, and the location 
of job information table (JIT). This is accomplished by 
having locations 2A, 2B, and 4F common to all Xerox mon- 
itors. Figure 12 illustrates the contents of these locations. 

Location 2A contains a flag that differentiates between an 
initial boot (nonzero) and a recovery boot (zero). 

Location 2B contains three items: 



1. 



Monitor — This field contains the code number of the 
monitor. The codes are as follows: 



Code 



Monitor 






None or indeterminate 


1 


BCM 


2 


RBM 


3 


RBM-2 


4 


BPM 


5 


BTM/BPM 


6 


UTS 


7 


CP-V 



Code 



9-F 



Monitor 



CP-R 



Reserved for future use 



2. 



3. 



Version — This is the version code of the monitor and is 
coded to correspond to the common designation for ver- 
sions. The alphabetic count of the version designation 
is the high-order part of the code and the version num- 
ber is the low-order part. For example, A00 is coded 
X 1 10' and D02 is coded X'42'. 

Parameters — The bits in this field are used to indicate 
suboptions of the monitor. They are meaningful only 
in relation to a particular monitor. However, the fol- 
lowing assignments have been made for BPM, BTM, 
and CP-V. 



Bit(s) 

31 set 
30 set 
29 set 
28 set 
27 set 

26 set 



Meaning 

Symbiont routines included. 

Remote processing routines included. 

Real-time routines included. 

Unused. 

Reserved for Data Management 
System . 



Reserved . 

24 reset; 25 set Computer is Sigma 6 or 7. 
24 set; 25 reset Computer is Sigma 9. 
24 set; 25 set Computer is Xerox 560. 

Location 4F contains the virtual J IT address right-justified. 



JOB INFORMATION TABLE (JIT) 

For each active job, the system maintains an in-core record 
(job information table) that allows the job to be scheduled 
and swapped. This job information table (JIT) is the first 
page of each job, both in core and on the swapping disk, 
and contains accounting information, memory map, swap 
storage, addresses, and other information for the job that 



2A 



Boot Flag 



2 3 I 4 5 6 7 I 8 9 10 111 12 13 14 15 1 16 17 18 t* 1 20 21 22 23I24 25 26 2? 1 28 29 30 31 



2B MONITOR 



Version 



Parameters 



1 2 3 4 5 6 7 8 9 10 111 12 13 14 15 16 17 18 19120 21 22 23 1 24 25 26 27128 29 30 31 



4F 



"S?: 


.......... ■;■•;'■':':'■ 


1 i| 

J IT Address 







2 3 f 4 5 6 7 


8 9 10 111 12 13 14 15ll6 17 18 19I20 21 22 23 1 24 25 26 27 1 28 29 30 31 



Figure 12. Locations Common to All Monitors 
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may be of use to a processor. In order to reference these 
values, the processor should REF the required symbol and 
then specify that :J0, the JIT definition package, be 
loaded along with the processor. The entire JIT is avail- 
able on a read-only basis to all programs including pro- 
cessors. Contents that are particularly useful to pro- 
cessors are given in Table 36. The complete contents 
are described in the CP-V Data Base Technical Man- 
ual, 90 19 95. 



Table 36. Partial Contents of JIT 



Location 


Size 


Contents 


J JIT 






(bit 0) 


1 bit 


Set if the job is on-line and 
reset if the job is batch. 


' (bil-'l) 


1 bit 


Set if the job is a ghost job. 
For example, the meaning of 
bits and 1 is as follows: 

00 batch job 

01 ghost job 
10 on-line 


.(bit 2) 


1 bit 


Set if user is a non-COC 
on-line user. (Bit also 
set. ) 


(bits 
16-31) 


halfword 


Job identification number 
that is guaranteed to be uni- 
que to each currently exe- 
cuting job. 


JB:LPP 


byte 


Number of printable lines 
per page (COC). 


JB:LC 


byte 


Current print line number 
(COC). 


JOPT 


word 


Peripheral usage flags set by 
TEL (see section titled "TEL 
Scan"). 


JrCCBUF 


20 words 


Image of the command line 
received by TEL. 


J:USER 


2 words 


On doubleword boundary for 
any use by installation. 


M:UC 


22 words 


Console I/O DCB. 



MEMORY CONTROL 

No special memory restrictions apply to programs operating 
as shared processors. In CP-V, as in any other time- 
shared or multiprogrammed system, prudent use of mem- 
ory can substantially improve system throughput. Requests 
for all available memory should be avoided. A request 
for enough memory to cover typical processing should be 
made initially, then a request for additional memory should 
be made during processing if the need arises. Memory 
should be returned to the system at major changes of 
control, but the frequent acquisition and release of mem- 
ory will increase system overhead out of proportion to 
the gain. 



With respect to accounting, only shared processors are 
processors, i.e., time spent compiling a COBOL program 
is accounted under "user time" while time spent in 
FORTRAN, PCL, etc., is considered "processor time". 



OVERLAY RESTRICTIONS 

Any processor intended for shared use may be created and 
debugged as an ordinary program. It may be coded in as- 
sembly language and debugged under Delta or created in 
FORTRAN and debugged with FDP. To qualify for inclu- 
sion as a shared processor, it must be coded within the 
following restrictions: 

1. Shared processors are allowed only one level of 
overlay. There is no restriction on the number of 
overlays but only one of them can be associated at 
a time. 



2. Data cannot be included in overlays; it must be in the 
processor root. 



3. Overlay names are restricted to seven characters or 
less. 



All parts of an overlay disappear from core when 
another overlay is called. (Portions of a previously 
used overlay are not available when a shorter overlay 
is invoked.) 



Shared processors written in FORTRAN must be pre- 
ceded by some Meta-Symbol code that associates the 
library and links to the FORTRAN code. 



6. The root must be greater than one page in length. 



When an overlayed shared processor is requested, the pro- 
cessor root and its first overlay are loaded. Assembled 
data and DCBs are loaded when the root is loaded. When- 
ever overlays are not required, memory usage can be held 
down by declaring an overlay length of zero and issuing a 
CAL to associate that overlay. 
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Overlays are declared and associated in the same way as 
they are for batch programs (CP-V/BP Reference Manual, 
90 17 64). TREE command cards and M:SEGLD remain the 
same. CSECT 2 and 3 are converted to CSECT 1 by CP-V 
loaders. 

Shared debuggers (Delta is the only current example) must 
have only one page of context and no overlays. They re- 
side in the special virtual area of high memory that is cur- 
rently fixed in virtual (not physical) size in the highest 
16K of virtual storage. They may be any physical size less 
than 16K including their context page. 



Appendix A. The default assignments for batch operations 
differ from those of on-line operations. This is done so that 
a program that writes through LO and reads through SI will 
automatically use the line printer and card reader for batch 
operations and the terminal for on-line operations. The 
logical functions associated with the operational labels are 
described in the CP-V/BP Reference Manual, 90 17 64. 

Details concerning input buffers, error handling, and so on 
are specified as parameters in a read or write call. Param- 
eters associated with files and devices are specified by the 
ASSIGN (batch) or SET (on-line) control command. 



DATA CONTROL BLOCKS 

Most processor I/O operations are performed through stan- 
dard monitor DCBs. For example, source input is norm- 
ally read by 

M:READ M:Sl[options] 

The standard DC Bs are 
M:BI 
M:CI 
M:EI 
M:SI 
M:C 
M:BO 
M:CO 
M:DO 
M:EO 
M:LO 
M:SO 
M:PO 
M:AL 
M:LL 
M:OC 
M:SL 
M:GO 



The default assignment of monitor DCBs is the operational 
label of the same name (M:DO is assigned to DO, etc.). 
The assignment of operational labels to devices is shown in 



A processor may construct its own DCBs by means of the 
M:DCB procedure. However, processors are not required 
to construct DCBs. DCBs not constructed by a processor 
will be constructed by the loader. Standard DCBs con- 
structed by the loader occupy 51 words and are connected 
to a device either by the loader or by an on-line user by 
means of special terminal commands. The M:DCB procedure 
must be used if optional parameters such as read or write 
accounts exceed the allocation of the standard DCBs 
(Table 37). 

DCBs are also provided in library form and may be explicitly 
called during a load. The sizes of these DCBs are shown in 
Table 37. 

Processors may use nonstandard DCBs, if necessary. Non- 
standard DCBs are constructed by the loader if not con- 
structed by the processor. They must be explicitly connected 
to a device either by an M:OPEN call in the processor or 
by a SET command issued by an on-line user since no default 
assignment via operational labels is provided. 

It is common practice for a processor to obtain source input 
through M:SI, to print a source listing through M:LO, and 
to print diagnostic output through M:DO. However, pro- 
cessor I/O operations are complicated by the fact that an 
on-line user can connect SI, LO, and DO either to differ- 
ent devices or to the same device (the on-line default as- 
signment for SI, LO, and DO is the terminal). In particular 
an on-line user may connect two or more of these standard 
operational labels to the same device. For this reason, 
processors must take precautions to avoid duplications in 
printed output. This means that processors must know at all 
times whether they were called in batch or in on-line mode 
and what specific device connections have been made for 
standard DCBs. 

Processors may examine DCBs directly to determine when 
the DCBs are connected to the same device. Fields within 
a DCB may be referenced relative to the name of the DCB. 
Fields that may be useful to processors are as follows: 

Field Use 

FCD Bit 10 of word Oof a DCB. This is the file- 

closed flag. A 1 means the associated file 
is open; a means the file is closed. 
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Table 37. Standard DCBs 



Name 


Device 


Name 


Account 


Pass- 
word 


Expiration 
Date 


Read 
Accounts 


Write 
Accounts 


Execute 
Accounts 


Execute 
Vehicle 


INSNS 


OUTSNS 


Synonymous 
Name 


Key 
Buffer 


Total 
Words 


Loader 
Built 
IX Bs 


22 


4 


3 


3 


3 












4 


4 





8 


51 


M:C 


22 


























22 


M:OC 


22 


























22 


M:BI 


22 


9 


3 


3 


3 










4 






8 


52 


M:CI 


22 


9 


3 


3 


3 










4 






8 


52 


M:SI 


22 


9 


3 


3 


3 










4 






8 


52 


M:EI 


22 


9 


3 


3 


3 


17 


17 


17 


4 


4 




9 


8 


116 


M:BO 


22 


9 


3 


3 


3 


17 


17 






4 






8 


86 


M:CO 


22 


9 


3 


3 


3 


17 


17 






4 






8 


86 


M:SO 


22 


9 


3 


3 


3 


17 


17 






4 






8 


86 


M:PO 


22 


9 


3 


3 


3 










4 






8 


52 


M-.LO 


22 


9 


3 


3 


3 










4 






8 


52 


M:LL 


22 


9 


3 


3 


3 










4 






8 


52 


M:DO 


22 


9 


3 


3 


3 










4 






8 


52 


M:GO 


22 


9 


3 


3 


3 
















8 


48 


M:EO 


22 


9 


3 


3 


3 


17 


17 


17 


4 


4 




9 


8 


116 


M:SL 


22 


4 


3 


3 


3 
















8 


43 


M:AL 


22 


4 


3 


3 


3 
















8 


43 



Field Use 

TYPE Bits 18-23 of word 1 of a DCB. These bits 

specify a code for the type of device con- 
nected to the DCB (printer, terminal, card 
reader, etc.). 

DEV Bits 24-31 of word 1 of a DCB. These bits 

specify an indexto the monitor device table. 



This means that processors must explicitly open DCBs for 
which device assignments will be tested. 



FILE IDENTIFICATION 

All on-line processors use a common format and common 
character set for constructing file identifiers (fid). The 
standard format is 



Under CP-V, all device assignments are direct. This 
means that DEV always contains a direct device assign- 
ment. A complete layout and description of DCBs is 
contained in the CP-V/BP Reference Manual, 90 17 64. 



The same effect can be obtained by the CORRES device 
CAL, but the CAL is much slower than the direct compar- 
ison. The direct comparison of the combined TYPE-DEV 
fields is meaningful only if the DCB has been opened. 



T. account "j 

J .account. password I 
L. . password J 



where name, account, and password consist of character 
strings with maximum lengths of 11, 8, and 8, respectively 
(name has a maximum of 131 characters for CCI, Edit, and 
PC L and a maximum of 10 characters for Link and Load). 
Any of the following characters may be used: 



A-2 



a-z 



0-9 



% 
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Lowercase alphabetical characters are not available on all 
terminals (e.g., Teletype Models 33 and 35). If lowercase 
letters are sent to these terminals, they are printed in upper 
case. 

Account and password are optional. If account is omitted, 
the log-on account is the default account. If password is 
omitted, no password is required to access the file. 



TEL SCAN 

A processor call entered through a terminal via TEL has the 
form 



s p] [over t rom ^ |Ist ]J 



wher 



Im is the name of the processor and is a file identi- 

fication (fid). Account :SYS is assumed. 

sp specifies a source program and may be either a 
file identification (fid) or a terminal identifica- 
tion (ME). 

ON indicates that ROM output is to be on a new 

file. 

OVER indicates that ROM output is to be over an 

existing file. 

rom specifies that the relocatable object module 

produced by the processor is to be directed to a 
specified file (fid). If no file is specified, out- 
put is directed to a special file that may be sub- 
sequently referenced by a dollar sign. 

list specifies that a file (fid), a line printer (LP), 
or the terminal (ME) should be used for listing. 
If list is not specified, no listing output is 
produced. 

These specifications are implicit ASSIGN and SETcommands 
for the DCBs M:SI, M:GO, and M:LO. A processor call 
causes the specified processor to be executed with M:SI DCB 
input from the file sp. Processor output through M:GO DCB 
is placed in the file specified by "rom" and listing output 
(M:LO DCB) is directed to the file or device specified 
by "list". Processor calls are interpreted by TEL. 

Parts of a processor call may be enclosed in parentheses. 
TEL does not do anything to these parts of a processor call. 
However, the processor may examine these and other parts 
of the command line that is in its JIT buffer (J.-CCBUF). 

Processors may reside in storage in three forms: 

1. System swap storage contains absolute shared copies 
of frequently-used processors. These copies can 
be located and loaded quickly. The absolute shared 



processor file is created during system initialization and 
contains reentrant processors that are shared among all 
concurrent users. 

2. The :SYS account may also contain copies of processors 
in load module form. Processors in this form cannot be 
loaded as quickly as absolute processors, but the :SYS 
account may be useful during processor construction, 
debugging, and extension. Public programs in the 
:SYS account may be called by entering their names in 
TEL commands or on control cards. 

3. A user may store his own processors or his copies of 
system processors in his own files (account). A pro- 
cessor stored in a user's file area is identified by its 
file name and may be called by the RUN command in 
batch or START command in on-line operations. 

When TEL encounters a processor call, it issues an exit CAL 
specifying the requested processor. The monitor routine 
STEP checks to see if this user has any processor restrictions. 
If the user is not restricted from using the requested pro- 
cessor, STEP checks to see if the processor is a shared pro- 
cessor. If it is shared, STEP checks to see if the processor 
is in core. If it isn't in core, STEP loads it into core. If 
the processor is not shared, STEP searches the :SYS account 
and loads the processor from there. If the processor cannot 
be found, an error message is sent to the terminal . Before 
control passes to the processor, TEL checks the parameters of 
the processor call for correct syntax and for existence of the 
"sp" file and a "rom" or "list". 

TEL sets and resets bits in JIT to correspond to the commands 
LIST, DONT LIST, etc., and to the initial occurrence of 
assignments in the command string. One JIT word (JOPT) 
contains a bit for each option that can be specified for a 
processor. The options and their corresponding bit assign- 
ments are as follows: 



Identifier 


Bit 


LO 


31 


BO 


30 


GO 


24 


DO 


23 



Set 



Reset 



LIST DONT LIST 

Unused Unused 

OUTPUT DONT OUTPUT 

COMMENT DONT COMMENT 



The underlined values are default values. If a SET command 
is issued for the corresponding DCB, or the list output or 
binary output fields are specified in a TEL command, the 
corresponding bits are set. Each processor must assign mean- 
ing to the bits and interpret them. Unassigned bits are 
available for future use. Checks of these bits should be 
made on each write command since TEL allows on-line users 
to interrupt the processor and turn on or off the LO, GO, 
and DO devices. 

Each processor should establish conventions to maintain 
orderly output when two or more DCBs are connected to the 
same device. The usual convention is that if diagnostic 
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output has been written via M:LO, and M:LO and M:DO 
are connected to the same device, then the diagnostic out- 
put should not be written via M:DO. The following ex- 
ample illustrates some of the special cases that processors 
should consider: 

1. M:SI, M:DO, M:LO connected to the same device 
(the input line should not appear three times). 

2. M:DO connected to a device that is different from SI 
and LO (the diagnostic comment should probably be 
printed beneath the line in error). 

3. M:SI and M:DO connected to a Teletype (processors 
may or may not want to type a line in error). 



Processors may read each input image via the M:SI DCB. 
The last record of the sp will cause an end-of-data abnor- 
mal condition (see the CP-V/BP Reference Manual, 90 17 04 
for a description of abnormal conditions). To obtain con- 
trol of an error or abnormal condition, a processor must 
issue the MrSETDCB command and/or include error and ab- 
normal exits in its read and write CALs. Since source input 
may come from a Teletype (sp = ME), processors must be 
able to handle Teletype input. The problems associated 
with Teletype I/O are discussed in the section on terminal 
I/O. 



CCI SCAN 

On transferring control to a user's program or to a processor, 
the monitor communicates the TCB address via general reg- 
ister 0. Processors may fetch the card image of the command 
that called them by reading through a DCB connected to the 
C device. 

When running in batch mode, the processor must read the 
C device once to clear the control command. The com- 
mand is transferred to the user's buffer to allow the user's 
program to examine parameters. 



END CHARACTERS 

On input from a Teletype, each record read is terminated 
by an end character (CR, FF, LF, RS, US, FS, GS). The 
end character, if any, is included in the actual record 
size (ARS) count reported in the DCB (bits 0-14 or word 4). 
Each processor must interpret the different end characters. 
Processors do not have to know that input is via Teletype, 
provided they treat these characters as terminators and use 
ARS to determine the actual record received. 

Source files for all processors, including those in batch 
operations, may have been prepared on-line. Since records 
prepared on-line are variable length, it may no longer be 
assumed that input records are 80-byte card images. 

All characters received from terminals, no matter of what 
type, are translated to the standard EBCDIC character set. 
The hexadecimal codes for EBCDIC characters are listed 
in Appendix H. 



WRITE OUTPUT 

The length of each output line is specified by the SIZE 
parameter in the M:WRITE procedure call. It is terminated 
only by the character zero. That is, the user may term- 
inate a message with a zero character if he wishes and 
the COC routines will compute the proper message length. 
Carriage return or new line characters do not terminate 
a message. 



CARRIAGE RETURN 

A new line or carriage return sequence, as appropriate to 
the type of terminal, is appended to the character string 
supplied by each write under the following circumstances: 

1. The DCB is not M:UC. 



2. The suppress space option is not specified. 



TERMINAL I/O 

An on-line user may direct output to his Teletype at any 
time during execution of a processor. Similarly, portions 
of the input to a processor may come from a Teletype. In 
general, Teletype I/O is the same as other I/O in its use 
of M:READ and M-WRITE operators and the standard abnor- 
mal and error situations. However, Teletype I/O has some 
features that are significantly different from those for other 
devices. Some of the differences require special attention 
by processors, but the interface is designed in such a way 
that processors will not have to know whether or not I/O 
operations are via Teletype, providing they observe certain 
conventions. On terminal I/O, like all I/O, the user 
should note that byte displacements in the DCB remain in 
effect until replaced, once they have been given. The 
special problems associated with Teletype I/O are outlined 
in the following paragraphs. 



Thus, under ordinary circumstances, carriage return char- 
acters will be supplied when output consists of one line per 
write and the DCB is connected to a terminal. By using the 
suppress space option or by writing through M:UC, the pro- 
gram may supply carriage returns exactly to requirements — 
either none or several for each write CAL. 



PARITY ERRORS AND LOST DATA 

When an M:READ CAL specifies a terminal, any character 
received with a parity error is replaced by SUB (USASCII 
code 1A) and the lost data abnormal code (07) is returned 
to the user if an abnormal address exists. If there is no 
abnormal address, control proceeds to the CAL plus 1. 
The line is returned to the user's buffer and the program 
may expect to encounter the SUB code as it scans. 
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In designing a response to messages that contain parity error 
characters, two facts are important: 

1. The user has already been informed of the error by the 
COC routines that echo the exact bits received on the 
line followed by the * character. 

2. If the received image is sent back to the terminal to- 
gether with an error message, the * character will be 
printed when SUB codes appear. 



In the absence of special considerations unique to the pro- 
cessor, it is recommended that lines received with lost data 
be sent back to the terminal together with the comment 
"EH?". This procedure is helpful as an aid in diagnosing 
faulty terminals and communication lines. 



END-OF-FILE 

If the user types the character pair ESC F, an end-of-file 
abnormal code will be returned to the program reading the 
terminal at the abnormal address (if there is one). An input 
line that contains all characters received prior to the end- 
of-file sequence will also be transmitted to the user's buf- 
fer. This line is always terminated with a carriage return 
which is also sent to the user's terminal. If no abnormal 
address is specified, the line appears as an ordinary input 
line. If both bad data and end-of-file occur in the same 
input, then the bad data is reported. 



OTHER ABNORMAL CONDITIONS 

If unknown operations are requested of the COC routines 
(e.g., write end-of-file), the abnormal code for beginning- 
of-tape will be returned. If there is no abnormal address, 
the operation will be ignored. 



FORMAT CONTROL 

COC routine action for the various formatting CALs is 
specified in the CP-V/TS Reference Manual, 90 09 07. It 
is briefly reviewed below. 

It is sometimes necessary to print a line with special spacing 
or without a carriage return. Processors can obtain verti- 
cal carriage control by means of two parameters (SPACE 
and VFC), both of which can be set by the DEVICE CAL. 
The SPACE and VFC parameters have the following inter- 
pretations for Teletypes. 



Parameter Meaning 

SPACE If this parameter is set and VFC is not on, the 

number of spaces indicated minus 1 is in- 
serted before each write. Counts of and 1 
result in single spacing. 



Parameter Meaning 



VFC 



If this flag is set, the COC routines simulate 
the printer's vertical format control as speci- 
fied in the first character of the text lines 
written. The simulation is limited to one of 
the following cases: 

Hex. Code Action 



Cl-CF 



Fl 



60, E0 



COC inserts 1-15 spaces be- 
fore printing. 

COC skips to top-of-page by 
skipping six lines and printing 
the heading information fol- 
lowed by the print line. 

COC does not insert CRLF 
after the print line (suppress 
space). 



For page control, COC routines count the number of lines 
transmitted to and received from the user's terminal. New 
page headings are printed for every read or write when the 
line count exceeds the maximum specified in JIT (via the 
PLATEN command). New page headings are also printed if 
the user program issues a PAGE device CAL or if the termi- 
nal user types the FF character L c (CONTROL L). 

Information in the page heading may be specified by the 
user by means of the HEADER and COUNT device CALs. 
Heading information is taken from the DCB through which 
the read or write was given. Thus, if a write call is issued 
to a Teletype through more than one DCB, the heading 
printed depends upon the DCB through which the top line 
of the page was written. The automatic page heading oc- 
cupies one line and contains current time, date, user name 
and account number, user identification and line number, 
page number, and possibly an administrative message. 
Headings specified in the DCB of the read or write are pro- 
duced after the automatic heading with position, text, and 
page number as specified in the CP-V/BP Reference Manual, 
90 17 64. The page count in this heading is that carried in 
the DCB and is reset with each COUNT device CAL. The 
page count for the automatic heading is carried in JIT and 
may be reset via the TEL PAGE command. The automatic 
heading is suppressed if the page length is less than eleven 
lines. Headings are also not printed if the automatic page 
heading is turned off via the TEL PLATEN command. 

Tab characters are replaced with an appropriate number of 
blanks in input lines. Tabs are not required in output lines. 
However, if a highly formatted output line is sent to the 
Teletype, the operation will be more efficient — and more 
satisfactory for the on-line user. Tabs are activated by in- 
serting a tab character (X'05')in the output stream. Tabs may 
be sent directly to the terminal or simulated by the software 
as requested by the terminal user who may turn simulation 
on and off using the sequence © T. When simulated by the 
software, each tab character in the output stream causes 
insertion of spaces to move the carrier to the right of the 
next higher position specified in the DCB. 
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Simulated tab stops can be set by a processor with the TAB 
device CAL or by an on-line user (for the M:UC DCB) with 
the TABS command. Tabs must be specified in ascending 
order beginning with tab stop position 1. Note that this 
is different from the line printer tabbing, where the tabs 
need not be in ascending sequence. Tab stops can be set 
at any time for any DCB. During output operations, tabs 
are expanded as specified by the DCB through which the 
write is issued or, if not specified there, as specified in 
the M:UC DCB. Tabs typed by an on-line user are simu- 
lated at the user's console according to the tab settings in 
theM:UC DCB. 



File extension takes effect at the time CP-V opens system 
output DCBs. The output DCBs that are affected by file 
extension are those that are currently assigned to files, al- 
though normally assigned to devices. They include: M:LO, 
LL, DO, PO, BO, SL, SO, CO, AL, EO, and GO. 



File extension is discontinued when a file is reassigned 
with a SET or ASSIGN command or when a file is opened 
with an OPEN procedure call that specifies an explicit 
file name. In these cases, a new file is created. Exten- 
sion of the GO file is terminated following a LINK or 
RUN command. 



If the backspace character is typed at the terminal, the 
character is passed to the reading program. No special 
action is taken by the COC routines other than that neces- 
sary to record current carrier position (which for backspace 
depends on terminal type). Terminals that have a physical 
backspace may, at the user's option, use a "backspace- 
edit" mode for intra-line editing. (Reference: CP-V/TS 
Reference Manual, 90 09 07.) 



A program can request control when the user presses the 
BREAK key by means of the M:INT procedure. Whenever 
the user presses the BREAK key, the program environment 
at the time of the break is recorded in the user's pushdown 
stack in his TCB. Execution can be returned to the loca- 
tion following the interrupted instruction by execution of 
the M:TRTN procedure. A program can return break con- 
trol to TEL by executing the M:INT procedure with a break 
routine address of zero. The break routine address is 
checked by the monitor to guarantee that the address lies 
within the memory allocated to the user. Even if a proces- 
sor has obtained break control, an on-line user can return 
execution control to TEL by pressing the © © , © Y, or 



Y° keys. 



SHARED FILE USE 

Shared processors must ensure that temporary files used 
during operation are distinct for each instance of exe- 
cution. A common technique for accomplishing this is 
to append the current users ID, from the right half of the 
first word of JIT, to the filename when it is created and 
used. This ID is guaranteed by the system to be unique 
for all concurrently running batch or on-line programs. 
A discussion of shared files is contained in CP-V/BP Ref- 
erence Manual, 90 17 64. 



COMMAND PROCESSOR PROGRAMMING 

A command processor is a shared processor which inter- 
faces between the user and that which the user wants to 
access — the monitor, a processor, or another program. 
Four command processors are supplied with CP-V. They 
are LOGON, TEL, CCI, and EASY. CP-V will also 
support installation-specific command processors. Infor- 
mation about the programming of command processors is 
outlined below. 



As a safety measure to protect the user against faulty pro- 
gramming in break control routines, the number of times the 
BREAK key is pressed by a user without intervening char- 
acters is recorded. When the count reaches four, control 
is sent to TEL as if Y° had been pressed. Thus, the user at 
the terminal will never find himself locked out. The count 
of four allows processors (e.g., FDP) to make special inter- 
pretations on two and three breaks in a row. 



FILE EXTENSION 



Generally, command processors have the same restrictions 
as listed for shared processors previously. In addition: 

1. A command processor may not have any overlay 
structure. 



2. A command processor which resides in the special pro- 
cessor area (above X' lC000')may not have any dynamic 
data and must be biased at X'1C400'. 



File extension is a convention by which records are added 
to an output file by successive job steps. Each time the file 
is opened, the file pointer (tape, disk pack, etc.) is posi- 
tioned to a point immediately following the last record in 
the file. Thus, when additional output is produced it is 
added to the previous contents of the file, thereby extend- 
ing it. File extension simulates output to physical devices, 
such as line printers or typewriters, when output is actually 
directed to a file. 



A command processor must intercept all exits, errors, 
and aborts from user programs and must clean up cor- 
rectly. (Special CALs for command processors are 
listed below. ) 



Command processors should not be given special JIT 
access. (The special CALs for command processor in- 
terface eliminate the need for it.) 
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5. When programs error or abort, control will be given to 
the command processor with the following restrictions: 

If the command processor resides in the user 
program area (X'AOOO 1 to X'lCOOO') or the user 
program is loaded in the extended mode (X'AOOO' - 
X'lFFFF'), the exiting user program will be com- 
pletely disassociated before associating the com- 
mand processor, eliminating the possibility of 
continuation of the job step. 

If the command processor resides in the special 
area (X'1C400' to X'lFFFF 1 ), has no dynamic 
data or DCBs, uses only M:UC, M:OC, and 
M:XX, control will pass to the command pro- 
cessor with the user intact, allowing analysis of 
the exit and continuation of the current job step. 



Command processors may be entered into the system during 
PASS2 of SYSGEN by using the T, B, G, and C flags of 
the :SPROCS command. They may also be added to the 
system, replaced, or deleted from the system via the DRSP 
processor. 



The job step processor arbitrarily removes the command 
processor from the user's virtual map. This means that 
all data and DCBs are gone. 



2. BREAK and CONTROL Y Control - If the terminal user 
depresses the BREAK key during operation of a pro- 
cessor or user program and that program did not request 
BREAK control, the program is aborted and the com- 
mand processor is loaded and entered with bit 30 of 
JrTELFLGS in the JIT set. If the interrupted program 
has requested BREAK control, the program's BREAK rou- 
tine is entered. 



If the terminal user depresses CONTROL Y during the 
execution of a processor or user program and the com- 
mand processor is not special shared, the program is 
aborted and the command processor is loaded and en- 
tered. If the command processor is special shared and 
has no data and no DCBs, the user program is left as is 
and the command processor is entered. This gives the 
command processor the opportunity to continue the 
interrupted program. 



The following capabilities are available to command 
processors: 

1. Interpretive Exit — An interpretive exit is a natural 
exit CAL (M:EXIT) performed by a command processor 
with the following register setup required. 

R6, R7 Contain the TEXTC name of the requested 

R8 load module or shared processor. A maxi- 

mum of seven bytes is allowed for a shared 
processor. If R6 is zero and the command 
processor is special shared, (biased at 
X'1C400'), the program is reentered at the 
point of interruption. 



R13, R14 Contain the account (in TEXT format) in 
which the load module resides. :SYS is 
specified for shared processors. 



RIO, Rll Contain the password in TEXT format. If 
there is no password, zero should be used. 



R0,R1 Contain either FDP or DELTA in TEXTC 

format or a zero. If one of the two debug- 
gers is specified, the interpretive exit is to 
be taken with the debugger associated. 



The system job step processor, STEP, interprets such an 
exit as a call on the specified program. It also loads 
the TEXTC name of the command processor that issued 
the interpretive exit into R4and R5. Before a com- 
mand processor issues an interpretive exit, it must have 
closed all its DCBs and, in general, have cleaned up. 



If the terminal user depresses CONTROL Y while a 
command processor is in control, the event is ignored 
and the current operation is continued where it was 
interrupted. 



If the terminal user depresses BREAK while a command 
processor is in control and BREAK control has not been 
requested or BREAK control has been reset via the 
M:INT CAL, the BREAK event isignoredand the com- 
mand processor is continued where it was interrupted. 
If a command processor has requested BREAK control, 
it is interrupted at its BREAK control address. 



The format of the BREAK control CAL is: 

CAL1,8 FPT 
where FPT points to word of the FPT shown below. 
Word 



X'OE' 



1 2 3U 5 6 7 



0- 







BREAK routine address 



9 10 11112 13 14 151 16 17 18 19120 21 22 23l24 25 26 27128 29 30 31 



If the CP bit is set, the BREAK control routine of the inter- 
rupted program is reestablished. This allows a user to 
depress CONTROL Y while in a program with BREAK con- 
trol, enter his special shared command processor which 
remembers the old BREAK control address, and then estab- 
lish BREAK control for the command processor. If the user 
wishes to continue, the command processor may set the 
CP bit and execute the BREAK control CAL before exiting 
back to the user's program. The BREAK routine address in 
this case should be the one that was active when the com- 
mand processor was first entered as a resultof CONTROL Y. 
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3. Exit, Error, Abort CAL, and I/O Abort Control - If 
any exit or abort condition occurs during execution of 
a program, the program is aborted and the command 
processor is loaded and entered. Error conditions are 
described in four fields of the JIT as follows: 



Bit 26 the maximum temporary disk space 

limit exceeded. 

Bit 27 the maximum permanent disk space 

limit exceeded. 



• J:ABC is the address of the word in the JIT that 
contains the abort code in byte (see Appendix B 
of the CP-V/TS Reference Manual, 90 09 07). 



• ERO is the word offset into the JIT of the word 
that contains the abort subcode in byte 3. 



JrRNST is the address of the word in the JIT 
that contains the current run status. Status set- 
tings are: 

All 

zeros means the job is executing normally. 

Bit 1 if set, the job is to be errored because of 
an M:ERR call to the monitor. 

Bit 2 if set, the job is to be aborted because of 
an M:XXX call to the monitor. 

Bit 3 if set, the job is to be errored because of 
an E key- in by the operator. 

Bit 4 if set, the job is to be aborted because of 
an X key-in or a line disconnect. 

Bit 5 is reserved for future use. 

Bit 6 if set, the job is to be aborted because a 
limit has been exceeded (e.g., maximum 
pages out). 

Bit 7 if set, the job is to be aborted because of 
an error (most likely I/O) as specified in 
J:ABC and ERO. 

Bit 8 if set, the job is to be aborted because of 
an illegal trap. 



J:ASSIGN contains the address of the word in 
the JIT, the rightmost nine bits of which indicate 
which limit was exceeded. This field is set in 
conjunction with bit 6 in the RNST field of the 
JIT. The bits, if set, mean: 

Bit 23 the maximum disk allocation limit 

exceeded. 



Bit 28 the maximum diagnostic pages output 

limit exceeded. 

Bit 29 the maximum user pages output limit 

exceeded. 

Bit 30 the maximum processor pages output 

limit exceeded. 

Bit 31 the maximum punch output limit 

exceeded. 



4. CAL Control of JIT Error Condition - This CAL a I lows 
control of JIT error conditions without special JIT ac- 
cess. The form of the CAL is: 

CALl/4 fpt 

where fpt points to the word shown below. 



X'06' 



0)2314567 







9 10 11112 13 14 15116 17 18 1SU20 21 22 23124 25 26 27 1 28 29 30 31 



The monitor (the ALTCP portion) verifies that the pro- 
gram issuing the request is a command processor through 
use of UH:FLG. It then sets J:ABC, ERO, byte of 
J:RNST, and bit 30 of JJELFLGS to zero. (Bit 30 of 
JrTELFLGS indicates whether or not the BREAK key has 
been depressed. ) If the program issuing the CAL is not 
a command processor, control is returned to the user 
program with CO set. 



5. Registers — Upon entry to a shared processor from a 
command processor, the registers must contain the 
following: 

R0 the TCB. address of the user program. 

R4, R5 the name of the calling command processor 

in TEXTC format. 

R6, R7, the name of the called processor in TEXTC 
R8 format. 

R10, Rl 1 the password in TEXT format (zero if none). 

R13, R14 the account of the called processor in TEXT 
format. 



Bit 24 the maximum time limit exceeded. 



Bit 25 the maximum scratch tape limit 

exceeded. 



6. CAL Control of Terminal Modes — Control of terminal 
modes is provided by a variation of the Change Ter- 
minal Type CAL (see the CP-V/TS Reference Man- 
ual, 90 09 07). 
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PUBLIC LIBRARIES 

The system may have several shared public libraries. Each 
library is a unit tailored to the requirements of the installa- 
tion. The user associates a public library with his program 
by specifying the library name (Pi where i =0 — 9, JO, or Jl) 
in a LINK or RUN command. The rule governing library 
units are as follows: 

1. Link loads the user data immediately above the area 
reserved for the library data. Load reserves an entire 
page for library data. 

2. No initialization is provided for this temporary library 
data either by the loader or by the system. There must 
be an initialization program if initialization is required. 

3. Each library unit must separate data (CSECTO) and pro- 
gram (CSECT1) information into separate assemblies so 
that separate ROMs will be produced for each. 

4. All code must be under CSECTs with protection type 
for variable data or 1 for procedure and constant data. 
No DSECT section may be used. 

5. The library must be self-contained (i.e., there can be 
no unsatisfied references). This must be true for the 
data portion itself and the total library. For example, 
a FORTRAN I/O library must search the DCB chain 
rather than make a direct reference to the DCB itself. 



CP-V PUBUC LIBRARIES 

CP-V contains four public libraries. One library (:P1) in- 
cludes the most commonly required routines from the Ex- 
tended FORTRAN IV and Extended FORTRAN IV-H library 
(about 65 routines). Another (:P0) includes :P1 plus the 
FORTRAN Debug Package (FDP). The third library (JO) 
contains the JIT definition. Most executing users need 
only the first library; users who are debugging need the 
second. The fourth library (J I) contains the monitor 
(M:MON) definitions and is useful only to programs 
which interface directly with monitor tables and routines. 

The entire Extended FORTRAN IV and Extended FORTRAN 
IV-H library consists of 266 routines (ROMs) totaling more 
then nine thousand instructions and over 800 data words. 

The package includes more than 350 DEFs. These routines 
are described in Extended FORTRAN IV Library Technical 
Manual, 90 15 24 and Sigma 5/7 Mathematical Routines 
Technical Manual, 90 09 06. 

Public library :P1 contains single and double precision 
trigonometric functions, exponential and logarithmic func- 
tions, standard set-up routines, initialization and termina- 
tion routines, and input/output conversion and transmission 
routines. Fewer than 300 words of storage are required 
for temporary storage by each user of the library. The 
4800 words of library code are shared among all con- 
current users. 



FDP users require public library :P0 which consists of nearly 
800 words of temporary storage per user; over 9700 words 
of code are shared among the concurrent users. 

The remaining 170 routines of the complete FORTRAN li- 
brary are organized in two ways: 

1. They are organized in the :BLIB file as card-image 
ROM decks that are used by the Link loader to satisfy 
library references. 

2. They are organized in the :LIB/:DIC files as 19 library 
load modules. 



This organization permits rapid loading by the batch loader 
(Load). Load uses the file :DIC, which consists of a record 
keyed by each DEF in :LIB and the group number as its 
value to find the LM names necessary to satisfy references. 

One essential monitor subroutine must be added to the stan- 
dard released library, S:OVRL. It is normally added dur- 
ing the System Generation process but must be remembered 
whenever a new library is being installed. 

The size and description of routines in :LIB are given in 
Table 38. 



CREATING PUBLIC LIBRARIES 

User's may add their own public libraries to meet specific 
requirements. The necessary procedures are given below. 

The procedure for creating public libraries consists of sev- 
eral steps. The desired data and program elements are 
loaded, and the dictionary for the library (DEFs) is filed 
for loader use. Next, the procedure is filed so that 
SYSMAK can place it on swap storage during system ini- 
tialization. In the process, the program SYMCON is used 
to retain only those DEFs required in the final linking pro- 
cess, thus saving loader stack search time. Figure 13 il- 
lustrates the process of creating a public library. 



LOADING PUBLIC LIBRARIES 

Default loading for Link includes the basic FORTRAN public 
library (:P1) and a search of the system (ROM) library if 
there are unsatisfied references. This is the same as if the 
user had specified (: PI) in a RUN or LINK command. If the 
user has not explicitly asked for :P1 and no reference to 
9INITIAL is found, the procedure for :P1 is not associated 
with the user program execution although the 350data words 
remain committed because of the single pass loader opera- 
tion. Figure 14 is a generalized flow of the LINK process 
relative to libraries. 

Since the batch loader operates in two passes, it makes an 
explicit association of :P0 and :P1 to a program in absence 
of other instructions. This process is illustrated in Figure 15. 
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Table 38. 


Routines in :LIB Library File 


Group 


Size 


Description 


1 


96 


Complex double precision mathe- 
matical routine drivers. 


2 


72 


Complex mathematical routine 
drivers. 


3 


108 


Double precision mathematical 
routine drivers. 


4 


192 


Single precision mathematical 
routine drivers. 


5 


260 


External revisions of compiler 
intrinsic functions. 


6 


676 


Complex double precision mathe- 
matical routines. 


7 


514 


Complex single precision mathe- 
matical routines. 


8 


114 


Double precision mathematical 
routines. 



Table 38. Routines in :LIB Library File (cont. 



Group 


Size 


Description 


9 


112 


Miscellaneous integer functions. 


10 


144 


Miscellaneous real functions. 


11 


98 


Logical functions. 


12 


30 


Conversion routines. 


13 


326 


DSINH, DTANH, DASIN, 
DTAN. 


14 


230 


FORTRAN II special functions. 


15 


24 


Overflow and divide check. 


16 


256 


Buffer-in/buffer-out. 


17 


668 


Input and INPUTL. 


18 


114 


Random Disk I/O. 


19 


514 


Disk buffer. 
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Figure 13. Public Library Creation Process 
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Error Message: 
Compiler for debug 
and library not 
associated. 



Read and Load 
Specified ROMs. 



Flag DCB REFs 
to be built later. 




( Done J 



Done 



Search for library 
files and load 
those found. 




Figure 14. Generalized Library Load Process (Link) 
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f Done J 



PUBLIC 
LIB 



Process ROMs or LMs 
from named files and/or 
from BI or GO. 




Determine which :Pn 
(either :P0 or PI). 



PUBLIC 
LIB 



Initialize UNSAT list. 




Get next UNSAT entry. 




Satisfy remaining REFs 
from :LIB in this account. 



no more 
entries 




.or9INITIALV" no 
o 



f Done J 



Determine which :Pn 
(either :P0 or :P1). 



PUBLIC 
LIB 



/ Done J 




Get the requested 
:Pn (from :SYS) and 
associate it with the 
load module being 
built. 



7T~ 

f Return J 



Note: If NOSYSLIB is present on the SLOAD card, the UNSAT list is empty or consists of those sources (accounts 
and/or :Pn) mentioned under the UNSAT option. If NOSYSLIB is not present, the UNSAT list consists of 
the above plus the :SYS account (which occurs last). 

Figure 15. Generalized Library Load Process (Load) 



Public Libraries 
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SHARED PROCESSOR MAINTENANCE 

Development and check out of CP-V systems is simplified 
through use of DRSP (Dynamic Replacement of Shared Pro- 
cessors). DRSP al lows replacement, creation, or deletion 
of shared processors while the system is operational. The 
extra processor space in the shared processor tables must be 
allocated during system generation (PASS2). Processors 
that are normally invoked following a recovery cycle 
(ALLOCAT, GHOST 1, RECOVERY, and XDELTA) are not 
dynamically replaceable. DRSP must be run as a shared 
processor in order to maintain integrity of the monitor's 
processor tables. 

Note: XDELTA (Executive Delta) is an additional debug- 
ging aid that is optionally retained at system ini- 
tialization. XDELTA is described in the Delta 
chapter of theCP-V/TS Reference Manual, 900907. 

DRSP can be run either as an on-line or a batch processor. 
Input can be either from the command device or from a 
terminal. DRSP is called on-line by entering the name of 
the processor as a TEL command. 

Example: 

J_DRSP© 

DRSP HERE 



The DCBs used by DRSP which may be assigned by the 
user are 

1. M:SI for command language input. 

2. M:LL for terminal output. 

3. M:SL for listing of input commands during a batch run 
and diagnostic message output. 



All of the above commands except " ?" can be followed 
by comments, which will be printed as part of the com- 
mand line during a batch run of DRSP. To add comments, 
terminate the command with a blank character followed 
by a period. All characters entered after the period are 
treated as comments. The comments are terminated by @ 
or end-of-card. Comments cannot be continued to the 
next record. 



ENTER The ENTER command is used to enter a new 

shared processor into the system. 



The format of the command is 



E[NTER] proname [{wnH^} fid ]^ ptlon J t^H D ^' ^ 



where the options are as follows: 

[J][S][D][P][M][T][B][G][C] specifies one or more 

flags to be associated with the processor. The 
flags indicate the following: 



J processor is allowed to alter the JIT. 

S special shared processor. 

D processor is a debugger. 

P public library. 



M processor allowed maximum memory during 
execution. 



T command processor accessible by terminal 

users. 



DRSP COMMANDS 

The seven DRSP commands are 

ENTER 

REPLACE 

DELETE 

LIST 

LISTALL 

? 

END 

In the DRSP command descriptions, the term "proname' 
refers to the name of a processor as found in the shared 
processor tables. The file specified by proname must be in 
load module format. 



B command processor accessible by batch 

users. 

G command processor accessible by ghost 
users. 

C command processor accessibly by terminal, 
batch, and ghost users. 

If Dor Pis specified, Sis redundant and is assumed. 
If the C flag is used, the specific flags (T, B, G) 
are redundant and should not be used. Various 
combinations of the above are possible up to a 
maximum of six characters; e.g., a processor that 
is allowed to alter the JIT and has maximum mem- 
ory available for execution would be flagged JM. 
The flag combination PD or usage of the P flag 
when the processor name is other than :Pnn results 
in an error message. 
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PERM specifies that the processor is to be available 
to users even after a system crash. The processor 
will be present both in the system account (:SYS) 
and on swap disk. "Empty" slots must be avail- 
able in the disk copy of the processor tables. If 
this option is not used, the new processor version 
will reside only on swap disk and will be lost in 
the event of a crash. The version of the processor 
that will be restored is the version in the system 
account at the time of the crash. 



W specifies that if the proname cannot be entered 
into the processor table because there are no name 
slots free, DRSP is to wait until there is a slot 
available. If this wait option is not specified, 
the command terminates without entering the 
new processor. 



REPLACE The REPLACE command is used to replace an 
existing shared processor. If this command is used, the 
previous version of the processor is lost. However, cur- 
rent users continue to use the old copy until they are 
disassociated from the processor. 

The format of the command is 

RJEPLACE] proname j W T-ri_i f ficl [pption][,option] [option] 

where the options are as follows: 

[J] [S] [D] [P] [M] [T] [B] [G] [C] specifies flags to be 
associated with the processor. The option is the 
same as for the ENTER command. 



PERM specifies that the new version of the pro- 
cessor is to be available to users even after a sys- 
tem crash. This version of the processor will be 
present both in the system account (:SYS) and on 
swap disk. "Empty" slots must be available in 
the disk copy of the processor tables. If this 
option is not used, the new processor version will 
reside only on swap disk and will be overwritten 
in event of a crash by the processor version in the 
system account. 



W specifies that if the proname cannot be entered 
into the processor table because there are no name 
slots free, DRSP is to wait until there is a slot 
available. If this wait option is not specified, 
the command terminates without replacing the old 
processor. 



DELETE The DELETE command prevents further user 
association with a processor. Users associated with the pro- 
cessor when this command is issued wVll continue to use the 
processor until they disassociate. 



The format of the command is 

D[ELETE] proname [, PERM] 

where PERM specifies that no new users will ever be asso- 
ciated with this processor (even after a system crash). 

LIST The LIST command lists the processor name, the 

name associated with each entry in the processor name table, 
and the amount of disk space occupied by the processor. 

The format of the command is 



L[ISTJ 



fproname"! 
l # xx[-yy]j 



whe 



proname specifies an explicit processor name. (The 

proname M:DUMLM appears many times in the pro- 
cessor tables. If selected, all these entries will 
be listed. ) 

xx-[yy] specifies the name table index or a range 

of name table indexes to be listed. 

Initial use of the LIST command with no proname or index 
specified will provide a list of each processor table entry 
and its corresponding table index. 



LISTALL The LISTALL command lists each shared pro- 

cessor name and its entries in the following tables: 

PB:HPP Head of the physical page chain. 

PB:TPP Tail of the physical page chain. 

PB:DSZ Number of data pages. 

PB:DCBSZ Number of DCB pages. 

PH-.PDA Disk address of first procedure page. 

PH-.DDA Disk address of first page of data and DCBs. 

PB:UC Number of users in core usingthe processor. 

PB:LNK Processor number of next overlay. 

PB:PVA Virtual page number of first procedure page. 

PB:HVA Virtual page number of first unused page. 

P:SA Processor flags and start address. 

The format of the command is 

[pronamen 



LISTALL 



fproname") 
l # xx[-yy]jj 



where proname and xxP-yy] are as defined in the LIST 
command. 
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? The question mark command requests a detailed error 

message when an error has been noted by DRSP. The com- 
mand is applicable only for the on-line mode. Its function 
is described in detail in the section "DRSP Error Messages". 
The format of the command is 



END The END command terminates DRSP. The format 

of the command is 



END 



DRSP LIMITATIONS AND RESTRICTIONS 

The following lists DRSP limitations and restrictions: 

1. Only users with a privilege level of CO or greater are 
allowed to use the ENTER, REPLACE and DELETE com- 
mands. The LIST command requires a privilege level 
of 80 or greater. 

2. There must be sufficient space in the swap disk 
processor/overlay area to hold the new or replacing 
entry. This extra space is allocated by SYSGEN 
PASS2 via a -.SPROCS control card. 

3. Replaced or entered items must be accessible load 
modules. 

4. Only one level of overlay is permitted in a processor. 

5. A processor overlay must be PROCEDURE only. 

6. ALLOCAT, GHOST 1, RECOVER, XDELTA, M:DUMLM 
may not be processed with DRSP commands. 

7. Overlays for processors cannot be replaced or entered 
individually. 

8. GETs of programs saved with an associated processor 
most likely will not work if the processor has been 
changed between SAVE and GET. 

9. When replacing the FILL processor a modified proce- 
dure is required: Following REPLACE FILL WITH 

N. A. P. , OPTION 1 thru 3, the user has to abort the 



FILL ghost. This is done via a message to the operator 
to key in X, id, where id is the SYSID of the FILL 
ghost which appears when the message 'REQUEST FILL, 
NO FILL, OR INSTANT SQUIRREL (F, N, S)' is output 
on operator's console. This will ensure that the FILL 
copy in the user swap disk area is destroyed and the 
replaced version of FILL is brought in the next time 
FILL wakes up. 



DRSP ERROR MESSAGES 

The error message structure of DRSP is designed to give a 
user detailed information when so desired without burdening 
him with long typeouts when the error is obvious. When 
running on-line, DRSP will respond to commands in error 
by typing 

EH@n 

where n is the character position at which an error was first 
detected. If the user requires more information, he responds 
with a question mark (?). DRSP responds with a detailed 
error message (see Table 39). If the error is obvious, the 
user may retype the command (or proceed to the next com- 
mand). For errors that occur after command syntax is com- 
pleted, this message changes to 



EH 



since command character position is meaningless. 

In batch mode, the detailed error messages are printed with- 
out the interrogative sequence described above. 

In addition to error messages, certain other messages are 
given for information purposes only (see Table 40). No re- 
sponse is expected. 

Except where noted, the error condition truncates execution 
of the requested command. 



DfiSP COMMAND SUMMARY 

Table 41 contains a summary of commands for the DRSP pro- 
cessor. The left-hand column specifies the format and 
the right-hand column defines the function. 



Table 39. DRSP Error Messages 



Message 


Meaning 


BREAK 50 
BREAK 51 
BREAK 52 
BREAK 53 


User hit BREAK during DRSP execution. The number defines the point at which 
the DRSP processor exited, as described in the UTS Reliability and Maintain- 
ability Technical Manual, 90 19 90. 


CANNOT OPEN THE FID 


DRSP cannot access the load module defined by the fid. 


CAN'T OPEN M:BO (PERM) 


I/O error detected while trying to open the output file in :SYS. The processor 
is entered/replaced on non-"PERM" basis. 
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Table 39. DRSP Error Messages (cont. ) 



Message 


Meaning 


DON'T USE COMMAND ON 
TEL/CCI 


ENTER or DELETE commands must not specify the proname 'TEL' or 'CO 1 . 


DRSP I/O ERROR IN READING 
COMMAND 


Error detected in reading DRSP command. 


DRSP I/O ERR/ABN (CLOSE) 


Error or abnormal condition detected at CLOSE of output file. The processor 
is entered/replaced on non-"PERM" basis. 


DRSP M:BO ERROR (PERM) 


I/O error detected while writing or closing the output file in :SYS. The 
processor is entered/replaced on non-"PERM" basis. 


DRSP M:EI ERROR (PERM) 


I/O error detected while reading file fid. The processor is entered/replaced 
on non-"PERM" basis. 


DRSP M : EI ERROR 
(WRITESWAP) 


I/O error detected while reading fid for writing on the swap disk. 


DRSP PROGRAM ERROR 
(SHOULDN'T HAPPEN) 


DRSP detected contradictory conditions during processing. Requires system 
programmer intervention. 


ERR MSG NOT FOUND. 
KEY = xxxxxx 


No error message corresponds to the error code xxxxxx generated. Please 
report this system error. 


FID IS NOT A LOAD MODULE 


Error or abnormal return executed while trying to read the TREE record of the 
load module specified by fid. 


FILE STORAGE LIMIT IN 
SYSTEM ACCOUNT 


When writing the load module into the :SYS account for the PERM option/ the 
file space for that account is exceeded. 


ILLEGAL COMMAND 


Command entered is not defined in DRSP. 


ILLEGAL COMMAND OPTION 


An optional parameter typed in the command is not recognized. 


ILLEGAL INDEX RANGE 


Index specified in LIST/LISTALL command not within legal range of processor 
name table. 


ILLEGAL LMN (LOAD 
BIAS CHECK) 


Illegal load bias detected when processor written to swap disk. 


ILLEGAL PRONAME, NOT 
:PNN FORMAT 


A processor flagged as a public library must conform to the name format :Pnn. 


ILLEGAL PROTECTION TYPE 
FOR PUBLIC LIBRARY 


The load module for a public library must be root only and procedure only. 


INCORRECT FID 


The fid specified exceeds the field maximum for name (15 characters) or 
account (8 characters) or password (8 characters). 


INSUFFICIENT MEMORY TO 
READ MAX RECORD OF FID 


DRSP has failed to acquire enough memory to read the largest record of the 
load module specified as fid. 


INSUFFICIENT MEMORY 
TO READ TREE 


Memory space available to user is not sufficient to process the load module 
specified in the ENTER or REPLACE commands. 


INSUFFICIENT PRIVILEGE 
FOR DRSP USAGE 


The user must have a privilege level of 80 or greater to execute any DRSP 
commands. 
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Table 39. DRSP Error Messages (cont. 



Message 


Meaning 


INSUFFICIENT PRIVILEGE 
LEVEL TO PROCESS THIS 
COMMAND 


The user does not have sufficient privilege of CO to process ENTER, REPLACE, 
and DELETE commands. 


INSUFFICIENT SPACE ON 
SWAP RAD 


The disk space allotted for new or replaced load modules is too small for the 
load module specified. 


INSUFFICIENT VIRTUAL 
MEMORY TO EXECUTE DRSP 


There are not enough virtual pages to allow DRSP to access the monitor. 


NO ERRORS 


No errors were encountered during command execution. 


NO PRONAME SLOTS AVAILABLE 


The number of extra processor name table entries is exhausted. 


NO SUCH PROCESSOR 


The proname entered cannot be found in the processor tables. 


ONLY ONE LEVEL OF OVERLAYS 
FOR SHARED PROCESSORS 


When analyzing the load module TREE record, more than one level of processor 
overlay was indicated. 


ONLY PROCEDURE IS ALLOWED 
IN A PROCESSOR OVERLAY 


DRSP checks a load module specified as an overlay for procedure only. 


OVLY LINK EXCEEDS TABLE 
LIMIT 


A system error to be reported. 


PROCESSOR OVERLAY SLOTS 
EXHAUSTED 


There are not enough empty processor overlay locations in the name table to 
fill the load module requirement. This check on the name table occurs during 
the write to the swap disk. 


PROCESSOR/OVERLAY 
ALREADY EXISTS 


User tried to ENTER a processor or overlay name that exists in the table. 


PRONAME IS ILLEGAL 


Some routine cannot be entered or replaced with DRSP (e.g., XDELTA, 
RECOVER, GHOST1, ALLOCAT, M : DUMLM). 


PRONAME REQUIRED 


A program must be specified with the ENTER, REPLACE, and DELETE commands. 


RAD OVERFLOW 


Disk space allotted for the shared processors is exhausted. 


READ ERROR READING 
FID (COPY) 


I/O error detected while trying to read the processor for the copy into the 
system account. 


SWAP I/O ERROR (QUEUE) 


I/O error detected while writing processor to the swap disk. 


WRITE ERROR WRITING 
FID (COPY) 


I/O error detected while trying to write the processor into the system account. 
The processor is entered/replaced on non-"PERM" basis. 


WRITE RAD FILE I/O ERRORS 


I/O error detected while writing the processor to the swap disk. 



Table 40. DRSP Information Messages 



Message 


Meaning 


DRSP HERE 


Routine title typed when user first enters DRSP. 


DRSP INHIBIT SET 


Another user is manipulating the shared processor tables and prevents any 
other user executing the ENTER, REPLACE, and DELETE commands. However, 
the LIST and LISTALL commands can be executed at any time. 



106 Shared Processor Maintenance 



Table 40. DRSP Information Messages (cont. ) 



Message 


Meaning 


fid NEEDS xxxx GRANULES 


If DRSP cannot find sufficient disk space in any available slot, it feeds 
back to the user the number of granules required to enter/replace the 
new load module. 


proname REPLACED IN RAD 
SLOT # x 


While exercising the "PERM" option, the proname in slot *x has been 
replaced by the proname specified in the current command. 


PRONAME FOUND ON RAD 


The proname already exists in the disk version of the processor tables when 
DRSP tries to execute the ENTER, PERM option. The "PERM" function is 
completed for the new copy. 


PRONAME NOT FOUND ON RAD 


The proname cannot be found in the disk version of the processor tables when 
DRSP tries to execute the REPLACE, PERM option. The "PERM" function is 
completed for the new copy. 


USERS ASSOCIATED 


DRSP attempts to replace TEL or CCI but finds there are users associated. The 
message is repeated periodically as long as users remain associated. 



Table 41. DRSP Command Summary 



Command 


Description 


D[ELETE] proname ,[PERM] 


Prevents further user association with a processor. 


END 


Exits normally from DRSP. 


E[NTER] proname 
[, option][, op 


(FROMl 1 
JWITH i fld ] 

tion][, option] 


Enters a new shared processor into the system. 


^K^} 


Lists the processor name, the name table index, and the amount of disk 
space occupied by the processor. 


LBTALL {EO 


Lists each shared processor name and its entries in certain tables. 


R[EPLACE] proname 
[, option][, optic 


"fFROMl ,. ,1 
IwiTHfH 

n][, option] 


Replaces an existing shared processor with a new shared processor. 


? 


Requests a detailed error message when an error has been noted by DRSP. 
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8. ON-LINE PERIPHERAL DIAGNOSTIC FACILITIES 



INTRODUCTION 

This chapter describes the system facilities that are designed 
for use by Xerox in the development of peripheral hardware 
diagnostic programs. The system procedures and the Diag- 
nostic DCB described in this chapter should never be used 
in any user-written programs. Their description is included 
in this manual only for completeness of documentation. Any 
program that uses them may seriously affect the operation 
and integrity of the system. 

The facilities described in this chapter are used in the fol- 
lowing types of Xerox processors: 

• Functional tests for peripheral devices that isolate hard- 
ware problems to the lowest possible level. 

• Exercisers that verify that the peripherals are operat- 
ing correctly. 

• Preventive maintenance tests that reduce the amount of 
time that peripherals are down for repair. 

These tests and exercisers may be run at an on-line terminal 
while the CP-V system is in normal operation. 

The facilities described in this chapter include one assem- 
bler directive, the special Diagnostic DCB (DDCB), and 
eight system procedures. The assembler directive allows the 
user to specify that a control section is to begin at a page 
boundary. The Diagnostic DCB is a data area that allows 
the user to issue his own I/O commands. 

These eight procedures reside in SYSTEM DIAG along with 
two other system procedures — MrDPART and D:DRET. 
(M:D PART and MiDRETare described in the SYSCON chap- 
ter in the CP-V/SM Reference Manual, 90 16 74, because 
they are used by SYSCON. ) The eight system procedures 
perform the following functions: 



Procedure Function 

M:DDCB Generates a diagnostic data control 

block. 

M:DOPEN Opens the device associated with the 
Diagnostic DCB for diagnostic purposes. 

MtDCLOSE Terminates and inhibits all I/O associated 
with the Diagnostic DCB. 

M:BLIST Converts the user's virtual command list 

into a physical command list and stores 
the result in the Diagnostic DCB. 

M:SIO Initiates the user's I/O. The commands 

for the I/O are stored in the Diagnostic 
DCB. 



Procedure Function 

M:LOCK Either locks the user in core or resumes 

normal swapping for the user. 

M:MAP Converts a specified virtual address to a 

physical address or a specified physical 
address to a virtual address. 

M:DMOD* Obtains the controller model number, 

the device model number, and the type 
mnemonic associated with a given de- 
vice address. 



RESTRICTIONS 

For both security and system performance reasons, there are 
certain restrictions on the use of the facilities described in 
this chapter. These restrictions are: 

1. The system manager must give approval before the sys- 
tem will process some of the CALs. (Note that M:DDCB 
does not generate a CAL. ) This approval is transmitted 
to the monitor via the operator key-in. 

IDIAG id 

where id is the diagnostic user's id and identifies the 
user as the current diagnostic user. This is reset by the 
monitor between job steps. 

2. The M:MAP procedure requires a privilege of A0 or 
higher. The user is aborted if his privilege level is 
insufficient. 

3. The M:LOCK, M:DOPEN, M:DCLOSE, M:BLIST, and 
M:SIO procedures require a privilege level of A0 or 
higher if the user has been specified as the current 
diagnostic user via the DIAG key-in, or a privilege 
level of CO or higher. If one of these two conditions 
is not met, the user is aborted. 



PSECT DIRECTIVE 

The PSECT directive specifies that the control section which 
follows is to begin on a page boundary. This directive allows 
diagnosticians to ensure that such things as the Diagnostic 
DCB and buffers do not cross page boundaries. The PSECT 
directive is described in detail in the Meta-Symbo!/LN, 
OPS Reference Manual, 90 09 52. 
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SYSTEM PROCEDURES 

Monitor procedures enable the user's symbolic Mefa-Symbol 
program to request a variety of monitor functions. The on- 
line diagnostic procedures described in this chapter have 
the same general format as those described in the CP-V/BP 
Reference Manual, 90 17 64. 

When using Meta-Symbol, the monitor diagnostic procedure 
library is invoked via the directive 

SYSTEM DIAG 

This directive defines all of the monitor procedures. The 
Sigma 6 and 7 computer instruction set is invoked by the 
directive 

SYSTEM SIG7[F] [D] [p] 

where F specifies the floating-point option, D specifies the 
decimal option, and P specifies privilege instructions. 

The Xerox 560 and Sigma 9 computer instruction sets are 
invoked by the directive 

SYSTEM SIG9[P] 

where P specifies the privileged instruction set. 

Thus, both the SYSTEM DIAG and the SYSTEM SIG7 or 
SYSTEM SIG9 directives should be used. The SYSTEM BPM 
directive should also be used if any of the procedures de- 
scribed in the CP-V/BP Reference Manual, 90 17 64, are 
used in the program. 



CREATE DIAGNOSTIC DATA CONTROL BLOCK 

M:DDCB The diagnostic data control block procedure 

generates a data area in the user's program that is accessible 
by the user. This data area must be given a label, the first 
two characters of which are F: (e.g., FrDIAG). 

The Diagnostic DCB (hereafter referred to as the DDCB) must 
be used when the diagnostician is going to perform his own 
I/O through use of the diagnostic procedures described in 
this chapter. In addition to containing standard types of DCB 
information, the DDCB contains the user's I/O command list. 
The DDCB format is described in detail at the end of the 
chapter. Because the DDCB has its own format, the only CALs 
that may be issued to the DDCB are the diagnostic CALs. 

The M:DDCB procedure call is of the form 

label M:DDCB (DEVICE, name), (CLIST, n)[, (option)]. . . 

where 

label is a label that begins with the two characters F : 

and must previously have been declared a dummy 
section via a directive of the form 



DEVICE, name specifies the device that is to be 
associated with the DDCB. Name may be speci- 
fied in one of the following forms: 

1. A device type in quotes (e.g., 'CR 1 , 'LP'). 

2. An operational label in quotes (e.g., 'LO', 
■EC). 

3. The physical address of the device expressed 
in hexadecimal (e.g., X'0080', X'0202'). 

CLIST, n specifies that n words are to be reserved 

for the user's command list. The maximum value 
that can be specified for n is 24. 

The options are: 



SN 



\,\, . . , .11 specifies one of the 

I [serial number J] r 



label 



DSECT 1 



following: 

1. The number of words (n) to be reserved for 
serial numbers. The serial numbers will be 
inserted into the DDCB when the DDCB is 
opened (M:DOPEN). The maximum value that 
can be specified for n is 12. 

2. The serial number of the volume to be used for 
input or output. The serial number may be 
from one to four alphanumeric characters. 

If the SN option is not specified in M:DDCB, then 
it cannot be specified in M:DOPEN. 

ABN, address specifies the symbolic address of a 
user's routine that is to be used to analyze any ab- 
normal conditions resulting from insufficient or con- 
flicting information. This address remains in the 
DDCB until it is overridden by an ABN specifica- 
tion in a DOPEN CAL. 

The CLIST and SN options produce variable-length param- 
eters which follow the fixed-length parameters in the DDCB. 
Each variable length parameter entry is preceded by a con- 
trol word of the following form: 

Byte is the code number (X'07' for SN; X'12' for 

CLIST). 

Byte 1 is the code for entry position (X'00 1 means 

more parameter entries to follow; X'OT means last 
parameter entry). 

Byte 2 is, for the SN option, the number of signifi- 

cant data words in the parameter entry when serial 
numbers are specified. Otherwise it is zero. 

Byte 3 is the total number of words reserved for the 

entry, not including the control word (i.e., maxi- 
mum entry length). 
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Special Note: 

After generating the DDCB, Meta-Symbol resumes assembly 
in the control or dummy section that was in effect when the 
MrDDCB procedure reference line was encountered. In 
order to prevent the statements following the MrDDCB pro- 
cedure reference line from being assembled in the same sec- 
tion as the DDCB, one of the following is recommended: 

1. The control section directive preceding an M:DDCB 
reference line shouldbe a CSECT, and the DSECTasso- 
ciated with an M:DDCB should precede the CSECT. 

2. The statement immediately following an M:DDCB pro- 
cedure reference line should be either a CSECT or a 
USECT referencing a prior CSECT. 



OPEN DIAGNOSTIC DATA CONTROL BLOCK 

M:D0PEN The monitor Diagnostic OPEN routine opens 

the device specified in the DDCB for diagnostic purposes. 
TheDDCBwill not be opened if the information in the DDCB 
is inaccurate, insufficient, or contradictory. In such case, 
the resulting abnormal or error code is returned in byte of 
register 10. If the M:DOPEN is made with no options spe- 
cified, the existing parameters in the DDCB are used. If the 
DDCB is already open when the DOPEN routine is called, 
an abnormal condition is signaled. If the DDCB is not open 
when the DOPEN routine is called, the DDCB is reinitial- 
ized according to the parameters specified in the M:DOPEN 
procedure call. 

Symbiont devices will only be opened if they have been 
locked, suspended, or partitioned. Nonsymbiont devices 
and devices opened with a device address specified {as 
opposed to device type or an operational label )must be par- 
titioned. Partitioning is accomplished by using SYSCON 
or as a result of a previous DCLOSE CAL with the PART op- 
tion specified. 

The M:DOPEN procedure call is of the form 

M:DOPEN [*]dcb name, (DEVICE, name), . 



(STATUS, [*] address )[, (option)]. . . 



where 



[*]dcb name specifies the name of the DDCB. 

DEVICE, name specifies the device that is to be 
associated with the DDCB. Name may be speci- 
fied in one of the following forms: 

1. A device type In quotes (e.g., 'CR', 'LP'). 

2. An operational label in quotes (e.g., 'LO 1 , 
'EO'). 

3. The physical address of the device expressed 
in hexadecimal (e.g., X'0080', X'0202'). 



STATUS, [*Jaddress specifies the address of the user's 
data area where the I/O status is to be stored. The 
status that is returned is in the same format as for 
the Error Log (see Appendix E). 

The options are: 

SN, "serial number'[, "serial number 1 ].. . specifies 

the serial number(s) of the volume(s) that are to be 
used for input or output. The serial number may be 
from one to four alphanumeric characters. A re- 
quest for the volume(s)willbe sent to the operator's 
console, which the operator responds to with an 
AVR sequence (e.g., MOUNT key-in). 

NOERR specifies that records of errors from this de- 
vice are to be suppressed from the Error Log. How- 
ever, the user has the option of writing records to 
the Error Log himself, with the Write Error Log CAL. 

ABN, address specifies the symbolic address of a 
user's routine that is to be used to analyze any ab- 
normal conditions resulting from insufficient or 
conflicting information. If an X'09" abnormal 
code occurs on the open, this open abnormal ad- 
dress is set into the DDCB and return is to this 
address. For other abnormals, the open abnormal 
address is not set in the DDCB and return is to the 
address previously set into the DDCB by M:DDCB 
or, if an address is not present, the user is aborted. 

CHAN specifies that the controller is to be reserved 
for use by this diagnostic program. A controller 
may be reserved only if it is partitioned. 

Calls generated by the M:DOPEN procedure have the form: 

CAL 1,6 fpt 

where fpt points to word of the FPT shown below. 

word 



X'05" 



0- 



-0 



DCB address 



~0 i 2 3 14 5 6 7 18 9 10 11112 13 14 15116 17 16 I9I2O 21 22 23124 25 26 27128 29 30 31 

word 1 



0- 



-0 



0- 



-0 



n 3 14 5 6 7 18 9 10 111 12 13 14 15l 16 17 18 19120 21 22 23 24 25 26 27 1 28 29 30 31 

word 2 - device code (PI) 



0- 



-0 



1 2 3 I 4 5 6 7 I B 9 1011112 13 14 15 16 17 18 19120 21 22 23 1 24 25 26 27128 29 30 31 



Device address 



device code (PI) alternate form 



0- 



-0 



1 2 3 14 56 7T8 9 10 111 12 13 14 15 



TEXT oplabel 



16 17 18 19120 21 22 23l24 25 26 27128 29 30 31 



where TEXT oplabel is an operational label in TEXT format, 
word 3 - STATUS (P2) 



0- 



Status address 



2 3 14 5 6 7 



10 11112 13 14 15116 17 18 19120 21 22 23124 25 26 27 1 28 29 30 31 
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option ABN (P3) 



Abnormal address 



1 2 3 14 5 6 7 18 9 10 11 1 12 13 14 15 1 16 17 18 191 20 21 22 23 T 24 25 26 27128 29 30 31 

Flags f i through fc in word 1 of the FPT have the signifi- 
cance indicated below (when f- = 1). 



Flag 


Significance 


f , 


NOERR was specified. Error records are to 
be suppressed from the Error Log for this 
device. 


f 2 


CHAN was specified. The controller is to 
be reserved. 


f 3 


SN was specified. Serial numbers are pres- 
ent in the FPT (in the format described 
below). 


f 4 


An operational label was specified. Word 2 
of the FPT has the alternate form. 


f 5 


Reserved for future use. 



The format for theSN variable length parameter is identical 
to that in the DDCB. The variable length parameter entry 
is preceded by a control word of the form: 

Byte — Code number (X'07 1 ) identifying the variable- 
length parameter. 

Byte 1 — Code for ^ntry position (X'00 1 means more 
parameter entries to follow; X'OV means last 
parameter entry). 

Byte 2 — Number of significant data words in the pa- 
rameter entry (if SN). 

Byte 3 —Total number of words reserved for the entry, 
not including the controlword (i.e., maximum 
entry length). 



If the user does not have at least A0 privilege, the return 
is to CAL+1 with CO set. 



The M:DCLOSE procedure call is of the form 

[ /PART \ 

M:DCLOSE [*]dcbname J RETURN 

1SAME I 

where 

[*]dcb name specifies the name of the DDCB. 

PART specifies that the device associated with the 
DDCB is to be partitioned from the system resources. 

RETURN specifies that the device associated with 

the DDCB is to be returned to the system resources. 

SAME specifies that the device associated with the 
DDCB is to remain in the same status (partitioned 
or not partitioned). The default is SAME. 

The Diagnostic CLOSE routine reports the status of the de- 
vice to the operator with the following message: 

..f PARTITIONED! 
yyndd lRETURNED J 

where yyndd identifies the device. 

Calls generated by the M:DCLOSE procedure have the form 

CAL1,6 fpt 

where fpt points to word of the FPT shown below. 

word 



X'07' 



0- 



-0 



DCB address 



01 2 3 I 4 5 6 7 I 8 9 10 111 12 13 14 15 f 16 17 18 19l 20 21 22 23 1 24 25 26 27 1 28 29 30 31 

word 1 



0- 







0- 



-0 



1 2 3 I 4 5 6 7 1 8 9 10 11 Il2 13 14 I5I16 17 18 19120 21 22 23 1 24 25 26 27 i 28 29 30 31 

where 

f , specifies the PART option when set. 

f^ specifies the RETURN option when set. 

f_ specifies the SAME option when set. 

If the user does not have at least A0 privilege, the return is 

to CAL+1 with CC1 set. 



CLOSE DIAGNOSTIC DATA CONTROL BLOCK 

M:DCL0SE The Diagnostic CLOSE routine terminates 

and inhibits I/O through the FrDIAG DDCB. I/O cannot 
be performed through the DDCB until it is opened again. 
M:DCLOSE allows the user to specify whether or not the 
device is down (partitioned). 



BUILD COMMAND LIST 

M'.BLIST The monitor BLIST routine converts the user's 

virtual command list into a physical command list and stores 
the results in the DDCB. The routine validates that no com- 
mand crosses a page boundary, that the flags in the command 
are correct, and that the number of I/O command double- 
words is less than or equal to 12. 
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The user's virtual command list must adhere to certain 
restrictions. 

• The list must use virtual rather than physical addresses. 

• No input/output command doubleword (IOCD) is 
allowed to perform I/O across a page boundary or spe- 
cify a byte count greater than one page (X'800 1 bytes). 

• The number of IOCDs must not be greater than 12. 

• The IOCD flags must be set as follows: 

IUE must always be set. 

IZC must always be reset. 

The last IOCD must always have ICE set. 

Command and data chained IOCDs must have ICE 
reset. 

The HTE flag must be consistently set or reset 
throughout all IOCDs that are data chained 
together. 

• I/O commands which do not cause a transfer of data 
(e.g., skip file, rewind) must have a valid byte ad- 
dress and byte count. 

The user may optionally request that the I/O be started. If 
this request is made, the monitor will not return control to 
the user until either the request to start I/O has been re- 
jected, the I/O is complete, or the I/O has timed-out. The 
AIO, TDV, and TIO status and condition codes are returned 
in the user area specified by the STATUS parameter of 
M:DOPEN and in the exact format as for Error Log (see 
Appendix E). 

The MrBLIST procedure call has the form: 

M:BLIST [*]dcb name, (ADR, [*]address)[, (option )]. .. 
where 

[*Jdcb name specifies the DDCB. 

ADR, [*Jaddress specifies the address of the user's 

command list. 

The options are: 



PRI, priority specifies the priority of the I/O re- 

quest as a hexadecimal number (e.g., X'F6'). 
X'FO' is the highest priority and X'FF' is the 
lowest priority. (The higher the priority, the 
higher the placement in the queue of requests for 
the channel containing the referenced device.) 



SIO specifies that the I/O Is to be started. 



Calls generated by the M:BLIST procedure have the form: 

CAL1,6 fpt 
where fpt points to word of the FPT shown below, 
word 



* X'09' 



0- 



-0 



DCB address 



1 2 3 ! 4 5 6 7 I 8 9 10 lit 12 13 14 15 1 16 17 IS I9I2O 21 22 23 1 24 25 26 27?28 29 30 31 

word 1 



0- 



■0 



0- 







I 2 3 14 5 6 718 9 10 11 1 12 13 14 151 16 17 18 19 1 20 21 22 23124 25 26 27 1 28 29 30 31 

word 2 - ADR (PI) 



0- 



Command list address 



1 2 3 I 4 5 6 7 18 9 10 11 M2 13 14 15 T 16 17 18 I9l20 21 22 23124 25 26 27128 29 30 31 



option PRI (P2) 



0- 



-0 



Priority 



75~1 5 3 I 4 5 6 7 Is 9 10 llll2 13 14 15l 16 17 18 I9I2O 21 22 23 1 24 25 26 27 1 28 29 30 3 

where f ] is set to one if SIO was specified. Otherwise, it 
is set to zero. 

If incorrect or conflicting information exists, the abnormal 
address specified in the DDCB will be used if it has been 
specified. If the user does not have at least A0 privilege, the 
return is to CAL+1 with CO set. 



START 1/0 

M:SI0 The start I/O procedure call initiates the diag- 

nostic I/O specified in the diagnostic DDCB. After an SIO, I 
the monitor will not return control to the user until either 
the call has been rejected, the I/O has been completed 
(successfully or with errors) or the l/O has timed-out. The 
AIO, TDV, and TIO status and condition codes are returned 
in the user area specified by the STATUS parameter of 
M:DOPEN and in the exact format as for Error Log (see 
Appendix E). 

The M:SIO procedure call is of the form 

M:SIO [*]dcb name 

where [*Jdcb name specifies the DDCB. 

Calls generated by the M:SIO procedure have the form 

CAL1,6 fpt 
where fpt points to word of the FPT shown below. 

word 



X»03' 



1 2 3 I 4 5 6 7 



0- 



-0 



DCB address 



9 10 IHI2 13 14 15116 17 18 19120 21 22 23i24 25 26 27l28 29 30 31 



If there is no command list in the DDCB or the validity of 
the command I ist has been destroyed by a swap, an abnor- 
mal condition results. If the user does not have at least AO 
privilege, the return is to CAL+1 with CC1 set. 
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LOCK IN CORE 



CONVERT ADDRESS 



M:LOCK The LOCK routine either locks the user in 

core or resumes normal swapping for the user. This lock in 
core reduces the user's chances of being swapped but does 
not ensure that the user will not be swapped. The user may 
ascertain whether a swap has occurred since the BLIST CAL 
by comparing J:NRS (the swap count) in the JIT with the 
SWAPCT field in the DDCB. (SWAPCT contains the swap 
count at the time of the BLIST CAL. ) The user has not been 
swapped if the two values are equal. (The external refer- 
ence J:NRS is satisfied by loading with :J0 from the :SYS 
account. ) 



The M:LOCK procedure call is of the form 



M:LOCK (JJ*) 



where 

YES specifies that the user is to be locked in core. 

NO specifies that normal system swapping is to re- 
sume for the user. 

Once a user is locked in core, his size may not change. 
Therefore, the following services are not allowed: 

1 . Memory management CALs. 

2. MrSEGLOAD, M.-LINK, andM:LDTRC procedure calls. 

3. Associate and disassociate processor CALs. 

4. Get page CALs. 

Calls generated by the M:LOCK procedure have the form 

CAL1,6 fpt 
where fpt points to word of the FPT shown below, 
word 



X'04' 



0- 



■0 



1 2 314 5 6 7 8 9 10 11112 13 14 151 16 17 18 19T20 21 22 23124 25 26 27128 29 30 31 

word 1 



o'i 



01 2 314 5 6 718 9 10 111 12 1314151 16 17 18 19 20 21 22 23124 25 26 27128 29 30 31 

where f] in word 1 specifies that LOCK in core has been 
requested (f j = l)or that the LOCK is to be released (f] =0). 

If the user's privilege level is not at least A0, the return is 
to CAL+1 with CO set. 



MlMAP The M:MAP procedure converts a specified 

virtual address to a physical address or a specified physical 
address to a virtual address. The converted address is stored 
in general register 8. The M:MAP procedure call has the 
form 

M :MAP (pyy ), (ADR, [*] address) 

where 

VTP specifies virtual to physical address conversion. 

PTV specifies physical to virtual address conversion. 

ADR, [*J address specifies the location of the address, 
to be converted. 

If the user has been swapped in between issuing a BLIST CAL 
and issuing a MAP CAL, the address returned from the MAP 
CAL is invalid. The user has not been swapped if J:NRS in 
the JIT is equal to SWAPCT in the DDCB. The user may 
reduce the chances of being swapped through the use of 
MrLOCK. 

Calls generated by the M:MAP procedure have the form 

CAL 1,6 fpt 

where fpt points to word of the FPT shown below. 

word 



* X'02' 



-0 



Add 



ress 



"6l 5 3 I 4 5 6 7 18 9 10 11 I 12 13 14 15 1 16 17 18 19 1 20 21 22 23 1 24 25 26 27 1 28 29 30 31 

word 1 



0- 



1 2 3 14 5 6 7T8 9 10 11 I 12 13 14 151 16 17 18 19 



20 21 22 23124 25 26 27128 29 30 31 



where f-i indicates virtual to physical address conversion 
(f] =0) or physical to virtual address conversion (f ] = 1). 

If the user's privilege level is not at least A0, the return is 
to CAL+1 with CC1 set. 



OBTAIN MODEL NUMBERS AND TYPE MNEMONICS 

M:DM0D# The DMOD # routine obtains the controller 

model number, the device model number, and the type 
mnemonic associated with a given device address. The for- 
mat of the procedure call is: 

M:DMOD# [*]device address 

where device address has the form ndd in which n specifies 
the IOP unit address (the number associated with the IOP 
letter; see Table B-2 in Appendix B) and dd specifies the 
device number (see Table B-3 in Appendix B). 
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Example: 

M:DMOD# X'20F' 



The procedure verifies that such an address exists. If no 
such device address exists, CC1 is set to one. However, if 
the device address is valid, CO is set to zero and the fol- 
lowing general registers are set: 



R8 is the device model number in hexadecimal 

(e.g., X , 00007122'). 



R9 is the controller number in hexadecimal 

(e.g., X'00007120'). 



RIO is the type mnemonic in EBCDIC (e.g., 

X'0000C3D9' for CR). 



In either case, the return is to CAL+1. 



Calls generated by the M:DMOD* procedure have the form 

CAL1,6 fpt 
where fpt points to word of the FPT shown below, 
word 



* X'OA' 



Device address 



01 2 3 I 4 5 6 7 18 9 10 11 1 12 13 14 15 1 16 17 18 19} 20 21 22 23 1 24 25 26 27I28 29 30 31 

word 1 



1 


n 


n 







1 2 


U 5 6 7 1 8 9 10 11112 13 14 15 1 16 17 18 19120 21 22 231 24 25 26 27128 29 30 31 



ABNORMAL CODES AND MESSAGES 

The codes and messages for abnormal conditions that can 
occur when using the on-line diagnostics facilities are listed 
in Table 42. (The messages reside in the system error mess- 
age file, ERRMSG.) 

DDCB 

The format for the DDCB is given in Figure 16. Following 
each format, the parameter fields of the DDCB are described 
in alphabetical order by their mnemonic. All referenced 
addresses have word resolution. 



Table 42. On- Line Diagnostics Abnormal Messages 



Abnormal 






Code 


Subcode 


Meaning of Code 


09 


00 


A diagnostic close is attempting to return a nonpartitioned device. 


09 


01 


The device referenced in the DDCB is a nonexistent device. 


09 


02 


The device referenced in the DDCB is currently in use. 


09 


03 


The device referenced in the DDCB is currently in use by a symbiont. 


09 


04 


The DDCB does not contain a command list. 


09 


05 


The command list was invalidated by a swap. 


09 


06 


There are more than 12 I/O command doublewords (IOCDs). 


09 


07 


The I/O command list is invalid due to either invalid flags, an invalid TIC address, an invalid 
user-specified command list address, or insufficient room in the DDCB for the command list. 


09 


08 


An error was found during the BUST CAL. Either an invalid page was found during physical-to- 
virtual or virtual-to-physical address conversion, the status address is in error, the byte count is 
illegal in the IOCD, or an IOCD overlaps a page boundary. 


09 


09 


A buffer crosses a page boundary. 


09 


0A 


The user's ID does not match the ID specified on the last operator DIAG key-in, or the user 
privilege level was less than A0. 


09 


0B 


The amount of available core is not sufficient to allow the diagnostic program to lock 
itself in core. 



114 Abnormal Codes and Messages/DDCB 



Table 42. On-Line Diagnostics Abnormal Messages (cont. 



Abnormal 
Code 


Subcode 


Meaning of Code 


09 
09 
09 

09 


OC 
0D 
0E 

OF 


The requested controller is not partitioned. 

The device specifically requested on an open is not partitioned. 

A MAP CAL error occurred due to an invalid page number during a physical-to-virtual or 
virtual-to-physical address conversion. 

Monitor buffer space (MPOOL) is unavailable for processing the command list. 





WordO 




F 


F 


|,,.,,,|.U.:.!.:.|........... ........ , . . .i.,.i.i..,i .H!....U.,M....,,,.,..n.. .., n, n, m, n .,■■■■■■■ i m ■ i ■ i ■■ i .,„■■,„ fc, „„„„,„„„„„„„..■ j 






TTL 
1 2 3 1 4 5 6 7 

Word 1 


8 


L 
I 

9 


L 
D 

10 


llil2 13 14 


"151 


16 17 18 19120 21 22 23124 25 26 27 


ASN-3 
28 29 30 31 




FUN 


T 
O 
L 
F 


D 
E 
V 
F 





TYPE 


DEV or OPLB 


1 2 3 1 4 5 6 7 
Word 2 


8 9 10 111 12 13 14 


15l 


176 


17 


18 I9I2O 21 22 23 


24 25 26 27!28 29 30 31 







llllllllllp^ 




1 2 3 1 4 5 6 7\ 
Word 3 


8 9 10 111 12 13 14 

1 


15M6 17 18 19l20 21 22 23(24 25 26 27? 28 29 30 31 




' 


ERA 








12 3 14 5 6 7 
Word 4 


8 9 10 11112 13 14 


15116 17 18 19120 21 22 23 1 24 25 26 27 1 28 29 30 31 

— 1 1 , 


CLSZ 




ABA 


1 
Wordi 


2 

D 
I 


3 


4 5 6 7 


8 9 10 111 12 13 14 15116 17 18 191 20 21 22 23 1 24 25 26 27 1 28 29 30 31 


1 


A 
G 

2 


3 1 


14 5 6 7 18 9 10 111 12 13 14 15 1 16 17 18 19120 21 22 23 124 25 26 27 1 28 29 30 31 



Figure 16. Format of the DDCB 
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Word 6 








FLP 






1 2 3 1 4 5 6 7 f 8 9 10 lit 12 13 14 
Word 7 


15 1 16 17 18 19l20 21 22 23 1 24 25 26 27I28 29 30 31 

— | 1 




6 1 2 3 1 4 5 6 7 18 9 10 111 12 13 14 
Word 8 




15ll6 17 18 19l20 21 22 23 1 24 25 26 27I28 29 30 31 


ft n 


u u 


12 3 14 5 6 7 
Word 9 , 


18 9 10 111 12 13 14 


15116 17 18 19120 21 22 23124 25 26 27128 29 30 31 

r—h : * ; 


1 2 3 f 4 5 6 7 1 
Word 10 


(may not be used) 
8 9 10 111 12 13 14 


15ll6 17 18 19I2O 21 22 23I24 25 26 27I28 29 30 31 






KBUF 










1 2 3 14 5 6 7 18 9 10 11 1 12 13 14 15 1 16 17 18 191 20 21 22 231 24 25 26 27 1 28 29 30 31 
Word 11 i 






COS or CIS 




c 

H 
A 
N 


f ■ 




1 2 3*1 4 5 6 \ 7 
Word 12 


18 9 10 llfl2 13 14 

^mmmmmmmmmm 


15 


16 17 18 19120 21 22 23124 25 26 27 1 28 29 30 31 

\ 1 

np\/irp 


1 2 3 1 4 5 6 7 1 8 9 10 11 f 12 13 14 
Word 13 


15ll6 17 18 19l20 21 22 23l24 25 26 27 1 28 29 30 31 


1 2 3 1 4 5 6 7 \b 9 10 11 1 12 13 14 15 ) 16 17 18 I9I2O 21 22 23I24 25 26 27I28 29 30 31 



Figure 16. Format of the DDCB (cont. ) 



116 DDCB 



Word 14 



STA 



1 2 3 1 4 5 6 7 I 8 9 10 llll2 13 14 15 1 16 17 18 19120 21 22 23124 25 26 27128 29 30 31 



Word 15 



TAB1 



1 2 3 I 4 5 6 7 18 9 10 11 1 12 13 14 151 16 17 18 19 1 20 21 22 23 1 24 25 26 27 1 28 29 30 31 



Word 16 


















012 3 


(4 


5 


6 


7 


18 


9 


10 11112 13 14 15116 17 18 19120 21 22 23124 25 26 27128 29 30 31 



Word 17 



1 2 3 I 4 5 6 7 i 8 9 10 111 12 13 14 15116 17 18 19 1 20 21 22 23T24 25 26 27 1 28 29 30 31 



Word 18 



I.,.! 



T~2 3 1 4 5 6 7 18 9 10 11 1 12 13 14 15116 17 18 19T2O 21 22 23 1 24 25 26 27(28 29 30 31 



Word 19 



SWAPCT 



0*"1 2 3 14 5 6 7 18 9 10 111 12 13 14 15 1 16 17 18 19 1 20 21 22 23 1 24 25 26 27 1 28 29 30 31 
Word 20 



*r 



1 2 3 I 4 5 6 7 18 9 10 1 1 T 12 13 14 1 5 f 1 6 1 7 1 8 1 9 1 20 21 22 23 1 24 25 26 27128 29 30 31 



Word 21 








PRI 


wS?: : : : :?Sw:?:%g&^ 


CLIST 


1 2 


3 14 5 6 7 


8 9 10 111 12 13 14 


151 16 17 18 19120 21 22 23 124 25 26 27128 29 30 31 



Words 22 — n are used for variable length parameters 



Figure 16. Format of the DDCB (cont. ) 
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FIELD 



DESCRIPTION 



WORD 



ABA Contains the address of the user's routine that will handle abnormal conditions resulting from 4 

insufficient or conflicting information. (The monitor returns to ABA in the FPT if the abnormal 
condition is the result of a device abnormality. ) 

ASN Indicates the assignment type currently in effect for the DCB (0 = null, I = file, 2 = Xerox 

labeled tape, 3 = device, X'A 1 = ANS labeled tape). 

CHAN Is the controller reservation flag (0 = no, 1 = yes). 11 

CIS Contains the relative position of the serial number (in the SN list) of the magnetic tape reel IT 

used for current file input. 

CLIST Contains the virtual address of the physical command list in the DDCB. 21 

CLSZ Contains the number of words in the physical command list in the DDCB. 4 

COS Contains the relative position of the serial number (in the SN list) of the magnetic tape reel 11 

used for current file output. 

DEV Contains the DCT index of the device assigned to the DCB. DEV is only meaningful if DEVF I 

is set to one. 

DEVF Indicates whether the DDCB is assigned to a device or an operational label (0 = operational 1 

label, 1 = device). 

DEVICE Contains the EBCDIC name specified on the DEVICE option in the M:DOPEN call. This use is 12 

only transient, and the field is later overlaid by CLK. 

DIAG Indicates diagnostic device DDCB. 5 

ERA Contains the address of the user's routine that will handle error conditions resulting from 3 

insufficient or conflicting information. 

FCD Indicates whether the DDCB is opened or closed (0 = closed, 1 = opened). 

FCI Indicates whether the DDCB has ever been closed. The flag is set when the DDCB is first closed, 

and then is never reset ( = DDCB has never been closed; 1 = DDCB has been previously opened 
and closed). 

FLP Contains the address of the variable length parameters in the DDCB (called the file list-pointer). 6 

FUN Contains the device mode function (0 = null / 1=IN, 2 = OUT, 3 = IN and OUT, 4 = INOUT, 8 = OUTIN). 1 

KBUF Contains the virtual address of the user's command list. 10 

OPLB Contains the OPLB table index of the operational label assigned to the DDCB. OPLB is only 1 

meaningful if DEVF equals 0. 

PRI Specifies priority of I/O request. 21 

STA Contains address of user data area used to return I/O status. 14 

SWAPCT Contains user's swap count at the time a diagnostic CAL is issued. 19 

TABl Contains the physical address of the command list in the DDCB. 15 

TOLF If 1, bits 16-31 of DDCB are TEXT OPLABEL. If 0, DEVF is meaningful. 1 

TTL Specifies the length of the DDCB in words. 

TYPE Contains the device type code assigned to the DDCB. This field is set whether the DDCB is assigned 1 

directly to a device or indirectly through an operational label. 
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9. REAL-TIME PROCEDURES 



Real-time processing involves reacting to external events 
(including clock pulses) within microseconds. Selected ex- 
ternal events are allowed to interrupt the real-time user's 
program so that they can be processed at the time they 
occur. After an interrupt has been processed, control may 
then return to the interrupted program or may be directed 
elsewhere. 

In CP-V real-time processing, there are three distinct types 
of interrupts: 

1 . Real, hardware interrupts. 

2. Multiple clock interval interrupts derived through soft- 
ware from a single hardware clock interrupt. 

3. User written pseudo-interrupts that are triggered by 
software rather than by hardware. This type of inter- 
rupt is quite useful for interprogram communication 
and synchronization. Pseudo-interrupts use interrupt 
addresses X'1000' through X'7FFF'. 

Note: Any interrupt connected by real-time procedures 
must have a hardware priority below that of the I/O 
interrupt. Note also that the swapper performs I/O 
at a software priority of X'10 1 . (This would be a 
consideration when specifying a priority to be as- 
sociated with certain real-time I/O requests; e.g., 
M:IDEX). 

CP-V real-time provides services that allow a user program 
to connect to and control interrupts, to request interruption 
at specified clock intervals, and to lock itself into core so 
that it will not be swapped out until it is ready to be 
swapped out. 

The following terms appear in the discussion of the real- 
time services: 



Enabled 

When an interrupt is in the enabled state, it is allowed to 
move to the active state when the interrupt signal is received 
provided that it is also in the armed state. If the interrupt 
is already in the waiting state, it moves to the active state 
when it becomes enabled, provided that no higher priority 
interrupt is currently active. 



Disabled 



An interrupt can undergo all state changes except that of 
moving from the waiting to the active state when it is in the 
disabled state. 



Acti> 



When an interrupt meets all of the conditions necessary to 
permit it to move from the waiting state to the active state, 
it is permitted to do so by being acknowledged by the com- 
puter, which then executes tne contents of the assigned in- 
terrupt location as the next instruction. 



Cleared 



When an interrupt is changed from the active state to the 
cleared state, the interrupt states are reset so that the in- 
terrupt can be recognized again and the priority is reset to 
that of the job that was running when the interrupt occurred, 



Interrupt Control Blocks (ICBs) 

Areas of memory set aside for use by the monitor interrupt 
processing routines. ICBs are established at SYSGEN. 



Disarmed 

When an interrupt is in the disarmed state, no signal to that 
interrupt is admitted; that is, no record is retained of the ex- 
istence of the signal, nor is any program interrupt caused 
by it at any time. 

Armed 

When an interrupt is in the armed state, it can accept and 
remember an interrupt signal. The receipt of such a signal 
advances the interrupt to the waiting state. 

Waiting 

When an interrupt in the armed state receives an interrupt 
signal, it advances to the waiting state, and remains in the 
waiting state until it is allowed to advance to the active 
state. 



Interrupt Label 

The two-character name of an interrupt. Interrupt labels 
are defined at SYSGEN. 



INTERRUPT CONNECTION AND CONTROL SERVICES 

CP-V real-time provides services that connect interrupts to 
mapped programs, control the state of interrupts (e.g., trig- 
ger, arm, enable, disable), clear interrupts either at time 
of occurrence or upon completion of processing, and discon- 
nect interrupts that are no longer required. Most of these 
services are provided through procedures which, except 
where noted, reside in 

SYSTEM RTPROCS 

and require real-time privilege (EO or higher). 



Real-Time Procedures 
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CONNECT INTERRUPT TO GHOST FILE 



word 



M-.GJOBCON The GJOBCON routine associates an 

interrupt with a load module such that if the interrupt oc- 
curs, the designated load module will be put into execu- 
tion as a ghost job. If the ghost job is already active as 
the result of a previous interrupt, the interrupt will be 
ignored. An interrupt occurring while the ghost is asleep 
(M:WAIT) causes a wake-up event. 

The M: GJOBCON procedure call has the form 



M:GJOBCON ONT^Mf^r}), 



-(LMN, 'load module') [, (ACN, 'account')]- 



-[,(PRIO, Apriority)] 



where 

INT, [*] interrupt specifies an interrupt address. 

INT, [*]'intlbl' specifies an interrupt label. If 
indirect addressing is used, the label must be in 
EBCDIC format, right-justified in the word, and 
preceded by blanks. 

LMN, 'load module 1 specifies the name of the load 

module to be placed in execution when the inter- 
rupt occurs. This will be the name of the re- 
sulting ghost job. The name must be seven char- 
acters or less in length. 

ACN, 'account' specifies the account of the load 
module and consequent running account for the 
ghost job. The default is the :SYS account. 

PRIO, [*]priority specifies the execution priority 
for the ghost job. The default is as follows: if 
'intlbl 1 was specified (via the INT keyword), the 
default is the SYSGEN-defined execution prior- 
ity associated within the interrupt label; if an in- 
terrupt address was specified (via the INT key- 
word) and the interrupt is a real interrupt, the 
default is n-X'4F' where n is the value of the 
interrupt address (e.g., programs attached to in- 
terrupt level X'60 1 would have a default execu- 
tion priority of X' 11 '); if an interrupt address was 
specified (via the INT keyword) and the interrupt 
is a pseudo interrupt, the default is the SYSGEN- 
defined default execution priority for ghost jobs. 

Calls generated by the M: GJOBCON procedure have 
the form 

CAL1,5 fpt 

where fpt points to word of the FPT shown below. 



X'20' 



12 314 5 6 7 



9 10 111 12 13 14 15 



Interrupt_add_ress 

Interrupt label (TEXT format) 

16 17 18 19120 21 22 23I24 25 26 27 1 28 29 30 31 



word 1 



PP 
1 2 



1 2 3 14 5 6 718 9 10 11112 13 14 15116 17 18 19120 21 22 23124 25 26 27128 29 30 31 



words 2 and 3 



Load module name in TEXTC 
format (S7 characters) 



1 2 3 I 4 5 6 7 I 8 9 TO 11 1 12 13 1-4 15116 17 18 19120 21 22 23 1 24 25 26 27 1 28 29 30 31 



words 4 and 5 (PI) 



Account name in TEXT 
format (S8 characters) 



1 2 3 I 4 5 6 7 Is 9 10 11 1 12 13 14 15 1 16 17 18 I9I2O 21 22 23 1 24 25 26 27 1 28 2V 30 31 



word 6 (P2) 



1 2 3 14 5 6 7 I 8 9 10 111 12 13 14 15116 17 18 19 1 20 21 22 23 



Priority 



24 25 26 27128 29 30 31 



Condition code settings resulting from an M:GJOBCON 
CAL are: 

CC1 - set if the user does not have real-time 

privilege. 

CC2 - set if no interrupt control blocks are 

available. 



CC3 - set if the interrupt specified is already 

connected. 



CC4 - set if the ghostalready exists. This-M:GJOB- 

CON procedure call is ignored. 



CONNECT USER PROGRAM TO INTERRUPT 

M: CONNECT Any mapped user program with real-time 

privilege may use this service to establish a connection to 
an interrupt such that the user program will be entered at 
the specified address when the interrupt occurs. Interrupts 
connected in this way report events to the CP-V execution 
scheduler and therefore permit the entered program to use 
all monitor services. The connected interrupt will be armed 
and enabled or disabled as specified by the user. 
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The M:CONNECT procedure call has the form 
M:CONNECT (INT, flfS^}), 



word 1 



-(ENTRY,[*]address)[, CLEAR][, MASTER] 



-[, DISABLE]^ PRIO, [*] priority] 



where 



INT, [*]interrupt specifies an interrupt address. 

INT, [*]'intlbl' specifies an interrupt label. If 
indirect addressing is used, the label must be in 
EBCDIC format, right- justified in the word, and 
preceded by blanks. 

ENTRY, [*]address specifies the address at which 
entry is to be made into the user program. 

PRIO,[*] priority specifies the execution priority 
for this interrupt. The default is as follows: if 
'intlbl' was specified (via the INT keyword), the 
default is the SYSGEN-defined execution priority 
associated with the interrupt label; if an interrupt 
address was specified (via the INT keyword) and 
the interrupt is a real interrupt, the default is 
n-X'4F' where n is the value of the interrupt 
address; if an interrupt address was specified (via 
the INT keyword) and the interrupt is a pseudo 
interrupt, the default is the SYSGEN-defined 
default execution priority for either on-line, 
batch, or ghost jobs, depending on the mode 
in which the job is being executed. 

CLEAR specifies that the interrupt is to be cleared 
immediately upon occurrence and reported to the 
scheduler. The default is to leave the interrupt 
active. 

MASTER specifies that the user is to be given con- 
trol in the master mode. The default is the slave 
mode. 

DISABLE specifies that the interrupt is to be con- 
nected, armed, and disabled. The default is to 
arm and enable. 



Calls generated by the MrCONNECT procedure have the 
form 

CAL1,5 fpt 

where fpt points to word of the FPT shown below, 
word 



X'21 1 



1 2 3 14 5 6 7 







-0 



8 9 10 111 12 13 14 15 



Interrupt address 

nterrupt label (TEXT format! 

i 17 18 19120 21 22 23l24 25 26 27I28 29 30 31 



1 2 3 14 5 6 7 18 9 10 111 12 13 14 15T16 17 18 19T20 21 22 23124 25 26 27128 29 30 31 



word 2 



Entry address 



1 2 3 14 5 6 7 18 9 10 11 1 12 13 14 151 16 17 18 19 1 20 21 22 23T24 25 26 27128 29 30 31 



word 3 (PI) 



* 



Priority 



TS\ 2 3 I 4 5 6 7 I 8 9 10 11 1 12 13 14 15 1 16 17 18 I9I2O 21 22 23124 25 26 27 1 28 29 30 3 

where 

M=l specifies MASTER mode. 

C=l specifies CLEAR. 

D=l specifies DISABLE. 

condition code settings resulting from an MrCONNECT 
CAL are: 

CC1 - set if the user does not have real-time 

privilege. 

CC2 - set if no interrupt control blocks are avail- 

able. (Interrupt control blocks are estab- 
lished at SYSGEN.) 

CC3 - set if the interrupt specified is already 

connected. 

The environment existing for the real-time program at the 
time of the interrupt occurrence is saved in the user's TCB 
before entering the specified interrupt routine. The TCB is 
identical to the one shown in Figure 5 except that the last 
word contains the interrupt location rather than a trap 
location. 



DISCONNECT USER PROGRAM OR GHOST JOB 
FROM INTERRUPT 

M-.DISC0NNECT The DISCONNECT routine releases 

the specified interrupt if it is associated with the current 
user. If honored, the M:DISCONNECT procedure disarms 
the specified interrupt and releases the associated interrupt 
control block. 

The M: DISCONNECT procedure call has the form 
M:DlSCONNECT (INT, Hfi^J'r}) 



/her 



INT, [*]interrupt specifies the interrupt address. 

INT, [*]'intlbl' specifies the interrupt label. If in- 

direct addressing is used, the label must be in 
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EBCDIC format, right-justified in the word, 
and preceded by blanks. 

Calls generated by the M:DISCONNECT procedure have 
the form 

CAL 1,5 fpt 

where fpt points to the FPT shown below. 



X'22' 



-0 



_ Interrupt address 

Interrupt iabeT~(TEXT forma~rJ 

lis 



1 2 3 I 4 5 6 7 8 9 10 111 12 13 14 15 16 17 18 19120 21 22 23124 25 26 27T28 29 30 31 

Condition code settings resulting from an M:DISCONNECT 
CAL are: 

CC1 - set if the user does not have real-time 

privilege. 

CC2 - set if the interrupt specified is not associ- 

ated with the current user. 

CC3 - set if the specified interrupt is currently 

active. 



CONTROL AN INTERRUPT 

MMNTCON This service permits a program with real- 

time privilege to control the states of interrupts. Interrupts 
may be armed, disarmed, enabled, disabled, or triggered. 
If the designated interrupt is a pseudo-interrupt, the action 
specified does not affect any real hardware interrupt but 
is instead recorded in the associated interrupt control block. 
The use of this service does not require that the user 
issuing the M:INTCON request be connected to the desig- 
nated interrupt, thus permitting inter-user interrupts. 

The M:INTCON procedure call has the form 



ARM, ENABLE 

ARM, DISABLE 

DISARM 

ENABLE 

DISABLE 

TRIGGER 



M:INTCON (INLMfl^r}),] 



INT, [*]interrupt specifies the interrupt address. 

INT, [*]'intlbl' specifies an interrupt label. If 
indirect addressing is used, the label must be in 
EBCDIC format, right-justified in the word, and 
preceded by blanks. 

ARM, ENABLE specifies that the interrupt is to be 
armed and enabled. 

ARM, DISABLE specifies that the interrupt is to be 

armed and disabled. 



DISARM specifies that the i nterrupt is to be disarmed. 

ENABLE specifies that the interrupt is to be enabled. 

DISABLE specified that the interrupt is to be disabled. 

TRIGGER specifies that the interrupt is to be 

triggered. 

Calls generated by the M:INTCON procedure have the 
form 

CAL 1,5 fpt 

where fpt points to word of the FPT shown below. 

word 



X'23« 







Interrupt address 

Interrupt labe^ (TEXT format) 

9T20 



1 2 3 I 4 5 6 7 8 9 10 111 12 13 14 15 16 17 18 19l 20 21 22 231 24 25 26 27 1 28 29 30 31 



word 1 



0- 



Code 



"i 2 Ttl 5 6 7 I 8 9 10 111 12 13 14 I5I16 1/ 18 19I2O 21 22 23^4 25 26 27 1 28 29 30 31 

where the 3-bit code has the following meanings: 
001 - DISARM 

010 - ARM and ENABLE 

011 - ARM and DISABLE 

100 - ENABLE 

101 - DISABLE 

111 - TRIGGER 

condition code settings resulting from an M:INTCON CAL 
are: 

CC1 - set if the user does not have real-time 

privilege. 

CC2 - set if the designated interrupt is not cen- 

trally connected (i.e., no M:CONNECT 
or M:GJOBCON has been performed on 
the interrupt). The request operation is 
not performed in this case. 



GENERAL INTERRUPT INHIBIT 

M:INHIBIT This service permits a program with real- 

time privilege to prevent itself from being interrupted by 
any higher priority real-time task. Note that this is a soft- 
ware (not hardware) inhibit and applies to both real and 
pseudo interrupts. 
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The M-.INHIBIT procedure call has the form: 
M:1NHIBIT{° N FF] } 



wh« 



ON specifies that the program is not to be interrupted. 

OFF specifies that the program may be interrupted 
and is the default. 



Calls generated by the M:INHIBIT procedure have the 
form 

CAL 1,5 fpt 

where fpt points to word of the FPT shown below. 

word 



X'23' 



I 2 3 I 4 5 6 7 18 9 10 1 1 I 12 13 14 151 16 17 18 191 20 21 22 23 1 24 25 26 2/128 29 30 31 



word 1 



r1~4 5 6 ft! 



9 10 11112 13 14 15116 17 18 191 20 21 22 23124 25 26 27 128 29 30 31 



where f specifies OFF if 0; or ON if 1. 

Condition code settings resulting from an M:INHIBIT CAL 
are: 

CC1 - set if user does not have real-time privilege. 



ARM[, ENABLE] specifies that the interrupt is to be 
left armed and enabled. (It is not necessary to 
specify ENABLE.) 

ARM, DISABLE specifies that the interrupt is to be 
left armed and disabled. (It is necessary to specify 
DISABLE.) 

DISARM specifies that the interrupt is to be left 
disarmed. 

None of the above options are recognized when exiting a 
clock-processing routine (see M:CLOCK below). 

Calls generated by the M:INTRTN procedure have the 
form: 

CAL1,9 X'OA' 

where the CAL instruction is as follows: 



X'04' 







0- 



-0 



X'OA 1 



1 2 3145 6 718 9 10 11112 13 14 15 i 16 17 18 19120 21 22 23124 25 26 27128 29 30 31 

where the 2-bit code has the following meanings: 

00 - LEAVE 

01 - DISARM 

10 - ARM and ENABLE 

11 - ARM and DISABLE 

When an error condition occurs, the user is aborted with an 
error code of either A301 or B802 (see Appendix B of the 
CP-V/BP Reference Manual, 90 17 64). 



RETURN FROM INTERRUPT PROCESSING 

M:INTRTN This service allows a mapped, scheduled 

program entered as the result of a centrally connected in- 
terrupt or elapsed clock interval to return to the point of 
interruption. The actual return is to the environment that 
existed for this program or user when the interrupt occurred 
even if this user was not in control when the interrupt oc- 
curred. The environment that is restored was saved in the 
user's TCB at the time of interrupt entry. 

The M:INTRTN procedure call has the form 



M:INTRTN 



LEAVE 

ARM[, ENABLE] 
ARM, DISABLE 
DISARM 



wher 



LEAVE specifies that the interrupt is to be left in 
its current state. LEAVE is the default for this 
procedure. 



QUEUE FOR INTERRUPT 

M:QFI This service permits the user to suspend execu- 

tion while awaiting interrupts or elapsed clock intervals as- 
signed a priority higher than the current execution priority. 
If there are no interrupts connected for this user that satisfy 
this condition, the user is aborted with a code of B8 and a 
subcode of 1 . 

The M:QFI procedure call has the form 

M:QFI 

Calls generated by the M:QFI procedure have the form 

CAL 1,5 fpt 
where fpt points to the FPT shown below. 



X'24' 



-0 



12314567189 



10 111 12 13 14 isll6 17 18 19I2O 2! 22 23 1 24 25 26 27 1 28 29 30 31 
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OBTAIN INTERRUPT STATUS 

IfclNTSTAT The service permits any user to query the 

I status of any real or pseudo interrupt location. The format 
of the MrlNTSTAT procedure call is 



M:INTSTAT (INT,^;^^} 



where 

INT, [*]interrupt specifies an interrupt address. 

INT, [*3* intlbl " specifies an interrupt label. If 
indirect addressing is used, the label must be in 
EBCDIC format, right-justified in the word, and 
preceded by blanks. 

The following word of information is returned to the user in 
general register 8: 



STAT 



USER 



GJOB# 







1 2 314 5 6 7 18 9 10 HI 12 13 14 151)6 17 18 19120 21 22 23124 25 26 27128 29 30 31 



where 



STAT indicates the status of the task associated 
with the interrupt location: 

STAT Meaning 

X'80 1 Task is active. 

X'40' Task is asleep or queued for interrupt. 

X'20' Task is waiting for I/O completion. 

X'10 1 Task is blocked and waiting for a 
resource. 

X'OT Specified interrupt is not currently 
associated with any user (i.e., 
inactive). 

USER is the user number of the user program which 
issued the M:CONNECT or M:GJOBCON. 

GJOB* is the user number of the ghost job (if it is 
active) which will be entered upon the occur- 
rence of the interrupt. If the ghost job is not 
active, GJOB* contains zero. 

T specifies that the interrupt has been triggered, 
if set to one. 

E specifies that the interrupt is enabled, if set to 
one. 

A specifies that the interrupt is armed, if set to 
one. 



Calls generated by the MrlNSTAT procedure have the form 

CAL1,5 fpt 
where fpt points to the FPT shown below. 



X'27' 



0- 



Interrupt address 

InterruptTabel, (TEXT format) 



01231456789 10 11112 13 14 15116 17 18 19120 21 22 23124 25 26 27128 29 30 31 

Condition code settings resulting from an M:INSTAT CAL 
are: 

CC1 - set if this is not a real-time system. 

CC2 - set if the specified interrupt is not currently 

associated with any user (i.e., inactive). 
(The STAT field of general register 8 is 
set to 01.) 



LOCK IN CORE SERVICE 

M:H0LD Many real-time applications require that a 

program be held in core while various forms of special I/O 
occur. Since the CP-V scheduler will swap users as con- 
ditions require in order to keep as many executable users 
in core as possible, it is necessary for those real-time pro- 
grams which require extended core residency to identify 
themselves via the M-.HOLD service. 

The format of the M:HOLD procedure call is 

m : hold{™} 



where 



ON specifies that swapping is to be prevented for 
this user (i.e. , the user is to be locked in core). 

OFF releases the hold. 



Condition code settings resulting from an M:HOLD call 
are: 

CC1 - set if user does not have real -time privilege. 

CC2 - set if there is not enough room left in core 

to hold the routine that allocates new disk 
space or the routine that communicates 
with the symbiont ghost. Any monitor ser- 
vice that invokes these routines must not 
be used in this case. 



Restrictions: 

1. The user must have real-time privilege. 

2. All memory management services which increase this 
user's size and the M:LINK and M:LDTRC services wil 
not be allowed once the user is held in core. 
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Lock in Core Service 



3. Monitor services may be further restricted if CC2 is 
set. All services requiring the allocation of new disk 
space or communication with the symbiont ghost are 
prohibited for the user. 

It is important to note that any program using M:HOLD 
should take exit control to cover abort conditions because 
if an abort or exit occurs while the user is locked in mem- 
ory/ the memory involved will not be released. 

Calls generated by the M: HOLD procedure have the form 

CAL1,5 fpt 

where fpt points to the FPT shown below. 



X'25' 



0- 



-0 f 



1 2 3 14 5 6 7 18 9 10 11 1 12 13 M 15 1 16 17 18 191 20 21 22 23124 25 26 271 28 29 30 31 

where f specifies ON if set to or OFF if set to 1. 



CLOCK SERVICE 

M: CLOCK This service permits a user with a privilege 

level of 80 or higher to request entry at a specified address 
when a specified time interval has elapsed. The format of 
the M:CLOCK procedure call is: 



M:CLOCK (ENTRY, [*]address), 



| [CANCEL 

[(INTERVAL, [*]units)[, (PRIO, [*] priori ty)]- 



[,ONESHOT][, MASTER]] 



where 



ENTRY, [*Jaddress specifies the address at which 
the user is to be given control when the specified 
interval has expired. The environment existing 
for the user at the time of the interval expiration 
is saved in the user's TCB as described under 
M:CONNECT. 

CANCEL causes any outstanding M:CLOCK requests 
for the specified entry address to be canceled. 

INTERVAL, [*Junits specifies the time interval in 
two-millisecond units. 

PRIO, [*J priority permits users with real-time pri- 
vilege to specify the software priority. This 
option is ignored if the user does not have real- 
time privilege. 

ONESHOT cuases the M:CLOCK request to be 
automatically canceled after one occurrence. If 
ONESHOT is not specified, the interval timing is 
to be automatically repeated until CANCELed. 

MASTER specifies that the user will be given con- 
trol in the MASTER mode. (This is only honored 



if the user has real-time privilege.) The default 
is the SLAVE mode. 

Calls generated by the M:CLOCK procedure have the form 

CAL1,5 fpt 

where fpt points to word of the FPT shown below. 

word 



X'26' 



0- 



■0 



Entry address 



1 2 3X4 5 6 7 8 9 10 1U12 13 14 15116 17 18 19120 21 22 23 1 24 25 26 27T28 29 30 31 



word 1 



P, R 



12 3 14 5 6 7 



word 2 (PI) 



1 2 3 14 5 6 7 



word 3 (P2) 







8 9 10 111 12 13 14 15 1 16 17 18 19 1 20 21 22 23 1 24 25 26 27 1 28 29 30 31 



Timer units 



9 10 11112 13 14 15116 17 18 19120 21 22 23124 25 26 27128 29 30 31 



Priority 



1 2 3 14 5 6 7 18 9 10 111 12 13 14 15116 17 18 19120 21 22 23124 25 26 27128 29 30 31 

where 

M specifies MASTER mode if set to 1. 

O specifies ONESHOT if set to 1. 

C specifies CANCEL if set to 1. 

Condition code settings resulting from an M:CLOCK CAL 
are: 

CC1 - set if no interrupt control blocks are 

available. 

CC2 - set if no interrupt control block is associ- 

ated with the user's entry address when 
CANCEL is specified. 

CC3 - set if user does not have a privilege level 

of at least 80. 



DEVICE PREEMPTION SERVICES 

PREEMPT DEVICE 

M:ST0PI0 Certain real-time applications require that 

there be direct control over the I/O associated with a par- 
ticular device and that there be no contention for a parti- 
cular device during certain critical processing periods. This 
includes the ability to request I/O end action off of the 
I/O interrupt associated with the I/O operation. 
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The real-time user may request that a specific device be 
preempted from use by any user other than a real-time user 
doing direct I/O to the device via the MrSTOPIO service. 
The following types of devices may not be preempted. 

Teletypes (i.e., Operator's Console) 

COC Devices 

Public RADs 

Public Disk Packs 

The format of the MrSTOPIO procedure call is 

MSTOP.O e^ttiad,,} [-<«.H»*a 
where 

DCB, L*Jdcb adr specifies that the device associated 
with this currently open device-type DCB is to be 
preempted from use by any other user. Only the 
user requesting the STOPIO may perform subsequent 
I/O to the device. 

DEV, L*JX 'device adr' specifies which device is to. 
be preempted from use by all but this user and is 
one of the following: 

ndd - a 12-bit physical address as used by 
Sigma hardware. 

cudd - a 14-bit physical address as used by 
Xerox 560 hardware (cluster/unit/ 
device). 

EA, L*Jvadr is the virtual address of a routine that is 
to handle any I/O interrupts from the device being 
preempted. This address is converted to a physical 
address and stored in the DCT tables. Therefore 
the user, prior to issuing the MrSTOPIO request, 
must have locked himself in core via the MrHOLD 
CAL. This routine is entered master mode, un- 
mapped, via a BAL on register 1 1 with the I/O 
interrupt active (high). Register 1 contains the 
AIO status of the interrupting device; register 2 
contains the right-justified address of the interrupt- 
ing device; byte of register 3 contains the con- 
dition codes as set by the AIO instruction; regis- 
ters 4and 5 contain the TIO status of the interrupt- 
ing device with byte of register 4 containing the 
condition codes as set by the TIO instruction; 
register 6 contains the physical address of the 
(user's) end-action-receiving routine; and register 7 
contains the DCT index of the interrupting device. 
No monitor services may be requested by the re- 
ceiving routine. All registers may be considered 
volatile except register 11 through which return 
to the monitor must be made. 

The DCB form of the M:STOPIO procedure call should be 
used whenever the user depends upon the operator to mount 



removable volumes on private spindles or tape drives. The 
DEV form should be used whenever the user wants a symbiont- 
type device (e.g., LP, CR, CP, RBT). Use of the DEV form 
to preempt any other device type results in an abnormal re- 
turn (see the condition code settings below). 

Calls generated by the MrSTOPIO procedure have the form 

CAL1,5 fpt 

where fpt points to word of the following FPT. 

word 



X'lC 



0- 



C DCB/device address 



1 2 3 14 5 6 7 8 9 10 1H 12 13 14 15116 17 18 19120 21 22 23124 25 26 27128 29 30 31 



word 1 







1 2 3 14 5 6 7 1 B 9 N> 11 1 12 13 14 15116 17 »8 19120 21 22 23124 25 26 27 1 28 29 30 31 



word 2 



G End action address 



1 2 3 14 5 6 718 9 10 1 1 1 12 13 14 15l 16 17 18 19120 21 22 23124 25 26 27128 29 30 31 

where 

f specifies DEV ir or DCB If 1 . 

f„ indicates that EA was not specified if or that 

EA was specified if 1. 

The return from the procedure call is to CAL+1 with the fol- 
lowing possible condition code settings: 

I 1 1 1 

device successfully preempted. 

1 user doesn't have real-time privileges; or the 
physical EA address is greater than 128K 
(Xerox 560 only). 

10 requested device is not preemptable (i.e., a 
public pack or RAD), is already preempted by 
another user, the specified DCB is not opened 
properly, or there was an illegal use of the DEV 
form. 

10 unknown device address; request ignored. 

10 requested device was associated with a sus- 
pended symbiont; request ignored. 

Should the application require that the multi-device con- 
troller (associated with the device to be preempted) also be 
preempted, the SYSCON processor should be used. This 
would, imply that the application cannot tolerate any con- 
tention for either the particular device or the multi-device 
controller associated with that device (tape drive or private 
disk pack). In the case of a disk pack controller, the 
spindles associated with that controller must have been de- 
signated as private. 
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RETURN PREEMPTED DEVICE 

MlSTARTIO Any preempted I/O device may be returned 

to the system via the M:STARTIO service. 

The format of the M:STARTIO procedure call is 

ti ctadtta J(DCB, Hdcbadr) 1 

M:STARTIO (p^ [*] X 'device adr')} 

where deb adr and device adr are as described under 
MrSTOPIO. 

Calls generated by the M:STARTIO procedure have the form 

CAL1,5 fpt 

where fpt points to word of the FPT shown below. 

word 



* X'lD' 



0- 



DCB/device address 



0~1 2 3 14 5 6 7 IB 9 10 11112 13 14 15116 17 18 19.1 20 21 22 23 1 24 25 26 27 1 28 29 30 31 



word 1 



I 4 5 6 7 I 8 9 10 111 12 13 14 15 



9l20 21 



16 17 18 19120 21 22 23124 25 26 27128 29 30 31 



where f specifies DEV if or DCB if 1. 

The return from the procedure call is to CAL+1 with the fol- 
lowing possible condition code 'Settings: 



n 34 


1 
10 

10 
10 



device successfully returned. 

user doesn't have real-time privileges. 

device wasn't preempted by this user, or the 
specified DCB is not opened properly, or there 
was an illegal use of the DEV form. 

unknown device address; request ignored. 

device was busy; request ignored. 

DIRECT I/O SERVICES 

I0EX SERVICES 



The M:IOEX service is provided as one means of enabling 
the real-time user to exercise direct control over I/O op- 
erations without having to run in the master mode (see also 
the M:EXU service). The only requirements are that the 
device specified be preempted (either via the M:STOPIO 
service or the SYSCON processor), and that an end-action 
routine be provided (either via M:STOPIO or M:IOEX). The 
I/O functions that can be controlled via M:IOEX are: 

SIO - Start input/output. 



HIO - Halt input/output. 
TIO — Test input/output. 
TDV — Test device. 



M:I0EX(SI0) 

dure call is 



M 



The format of the M.-IOEX (SIO) proce- 
f (DCB,. Hdcbadr) 



f(DCB,L*Jdcbadr) 1 

:1 ^ I (DEV, [*]X'deviceadr')J' 



-(SIO, [*]clist[,REL])[,(EA, [*]vadr)] 



-D(TO,[*]value)[,(PRI,[*]prio)] 



where 



DCB, [KJdcb adr specifies that the I/O function is 
to be performed for the device associated with the 
currently open DCB addressed. 

DEV, MX'device adr' specifies the device for which 
the I/O function is to be performed and is one of 
the following: 

ndd — a 12-bit physical address as used by 
Sigma hardware. 

cudd —a 14-bit physical address as used by 
Xerox 560 hardware (cluster/unit/ 
device). 

SIO, L*Jclist is the starting virtual address (double- 

word bound) of the I/O command list to be initi- 
ated. All buffer addresses within the command list 
itself must be physical addresses. 

REL specifies that the channel is to be released af- 
ter issuing the SIO. This would be used with 
command lists which do not result in data transfer 
operations (e.g., seek orders, rewind orders, head- 
positioning orders). 

EA, [*]vadr is as described under M:STOPIO; the 

M.-HOLD requirement applies to M:lOEX also. 

TO, L*Jvalue is the number of 4.8 second intervals 
allowed to elapse following the issuance of the SIO 
instruction before the EA address will be entered. 
In this case, the user's EA routine is entered master 
mode, unmapped, via a BAL on register 1 1 with 
registers 1 and 2 equal to zero. Register 7 contains 
the DCT index and register 6 contains the physical 
address of the (user's) end-action-receiving routine. 
Byte of register 3 contains the condition codes as 
set by the SIO instruction; registers 4 and 5 con- 
tain the SIO status registers' information. No mon- 
itor services may be requested by the receiving 
routine. All registers may be considered volatile 
except register 1 1 through which return to the mon- 
itor must be made. A time-out value of zero 
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implies that no time-out facility is desired (default), 
however the user's EA address will always be en- 
tered should an SIO failure occur (in this case 
register 1 will be nonzero). 

PRI, l*3prio is the priority at which to queue the 
request and is a value between and X'FF'. The 
default is the value of the user's current execution 
priority. 



Table 43 summarizes the various possible register settings 
for end-action routines. 

Galls generated by the M:IOEX (SIO) procedure have 
the form 

CAL1,5 fpt 

where fpt points to word of the FPT shown below, 
word 



* X'lE" 



12 3 14 5*7 







-0 



DCB device address 



8 V 10 11112 13 14 15116 17 18 19120 21 22 23124 25 26 27128 29 30 31 



all 



word 1 



1 2 3 14 5 6 7 18 9 10 1 1 1 12 13 14 15 



Of 



16 17 18 19120 21 22 23124 25 26 27l28 29 30 31 



word 2 



* 



Command list address 



1 2 3 I 4 5 6 7 Is 9 10 111 12 13 14 151)6 17 18 19 1 20 21 22 23 1 24 25 26 27 1 28 29 30 31 



word 3 (PI) 



End-action address 



1 2 3 14 5 6 7 18 9 10 11 1 12 13 14 151 16 17 18 19120 21 22 23124 25 26 27128 29 30 3! 



word 4 (P2) 







Time-out 
value 



1 2 3 14 5 6 7 18 9 10 111 12 13 14 151 16 17 18 19120 21 22 23124 25 26 27128 29 30 31 

where f specifies DEV if or DCB if 1. 

The return from the procedure call is to CAL+1 with the fol- 
lowing possible condition code settings: 

1^34 

]/0 request successfully queued. 

1 user doesn't have real-'time privileges. 

10 specified device doesn't exist or the specified 
DCB is not opened properly. 

10 EA was not specified and the DCT tables 

do not contain the address of an end-action 
receiver; or the physical address EA is 
greater than 128K (Xerox 560 only). 



10 specified device is not preempted, or has 
been preempted by another user. 



Table 43. Register Settings for End-Action Routines 



Register 




Contents when Routine Entered 


Contents when Routine Entered due to 






due to Interrupt 


Timeout or SIO Failure 


R0 




- 


- 


Rl f 




AIO status. 


0= timeout; Nonzero = SIO failure. 


R2* 




Device address. 





R3 




AIO condition codes (byte 0). 


SIO condition codes (byte 0). 


R4and 




TIO status; byte of R4 contains the 


SIO status (if timeout). 


R5 




condition codes from TIO. 




R6 




Physical address of EA routine. 


Physical address of EA routine. 


R7 




DCT index. 


DCT index. 


f Rl and R2 


indicate how the end-action routine was entered. 
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M'.IOEX (HIO/TIO/TDV) The format of the M : IOEX 

(HIO/TIO/TDV) procedure call is 



M:IOEX 



{(DCB, [*]dcb adr 
l(DEV,[*]X 'device 



adr')! 7 



HIO 
TIO 
ITDV. 



where deb adr and device adr are as described under 
MrlOEX. 

Calls generated by the M:IOEX (HIO/TIO/TDV) procedure 
have the form 

CAL1,5 fpt 

where fpt points to word of the following FPT. 



word 








* 


X'lF' 





— 


DCB/device address 





1 2 3 1 4 5 6 7 


8 9 10 11 


12 13 14 


15 1 16 17 18 19l20 21 22 23 1 24 25 26 27 1 28 29 30 31 



word 1 



n n 


f 


, _( 


Code 


U U 


u u 


1 2 3 1 4 5 6 7 18 9 10 111 12 13 14 


15 


16 17 18 19 I'M 21 22 23 1 24 25 26 27 


28 29 30 31 



where 

code is: 

if TIO 

1 if TDV 

2 if HIO 

f specifies DEV if or DCB if 1. 

The return from the procedure call is to CAL+1 with the 
condition codes and registers set as if the user had issued 
the following instruction: 



HIO 
TIO 
ITDV. 



,8 X'device address' 



Since the condition codes cannot be used to communicate 
abnormal conditions for any of the above three services, 
any of the abnormal conditions indicated below will result 
in a program abort (code B9, subcode as indicated). Such 
aborts may be intercepted by the user via TRAP control 
(M:TRAP procedure call specifying CAL). 

Subcode Meaning 

01 User doesn't have real-time privilege. 

02 Specified device doesn't exist, is not pre- 
empted by this user, or the specified DCB is 
not opened properly. 



EXECUTE PRIVILEGED INSTRUCTION SERVICE 

M:EXU The M:EXU service is provided as another way 

to enable the real-time user to execute I/O instructions 
and other privileged instructions without having to run in 
the master mode (see also the M:IOEX Service). The only 
requirement is that the instruction op code to be executed 
be one of the following: 



Op Code 


Mneumonic 


X'4C 


SIO 


X'4D' 


TIO 


X'4E' 


TDV 


X'4F' 


HIO 


X'6C 


RD 


X'6D' 


WD 



The SIO execution service is intended primarily for inter- 
facing to devices not known to the operating system (DCT 
tables) and which do not generate I/O interrupts (X^C 1 ). 
However, no validity checks are made and if the SIO will 
result in an I/O interrupt, it is assumed that the user will 
have provided an end-action receiver via the M:STOPIO 
service. 

For a complete discussion of the M:EXU service, see the 
CP-V/BP Reference Manual, 90 17 64. 



ENTER MASTER MODE 

MlMASTER The M:MASTER procedure allowsg user with 

sufficient privilege level (CO or higher) to operate in the 
master mode (master-protected mode if running on a Sigma 9 
or Xerox 560) with a write key of 1. (This procedure resides 
in SYSTEM BPM. ) The format of the procedure call is 

MrMASTER 
Calls generated by the M:MASTER procedure have the form 

CAL1,5 fpt 
where fpt points to the FPT shown below. 



X'08' 







i 2 3 I 4 5 6 7 I 8 9 10 11 1 12 13 14 15 1 16 17 18 19 i 20 21 22 23 1 24 25 26 27 1 28 29 30 31 

If the caller's privilege level is not sufficient, return is to 
CAL+1 with CC1 set. 



ENTER SLAVE MODE 

NhSLAVE The M:SI_AVE procedure allows any master 

(and master-protected) mode program to return to the slave 
mode. (This procedure resides in SYSTEM BPM.) The for- 
mat of the procedure call is 

MrSLAVE 
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Calls generated by the M:SLAVE procedure have the form 
CAL1,5 fpt 

PSECT DIRECTIVE 

The Meta-Symbol PSECT directive specifies that the control 
section which follows is to begin on a page boundary. The 
directive can be useful for controlling the placement of I/O 
buffers, data, and end-action-receiving routines which will 
be accessed unmapped. 

VIRTUAL/PHYSICAL ADDRESS CONVERSION 

M:MAP The M:MAP procedure converts a specified 

virtual address to a physical address or a specified physical 
address to a virtual address. The converted address is stored 
in general register 8. The M:MAP procedure call has the 
form: 



M:MAp{p T y}, (ADR, [*]address) 



where 

VTP specifies virtual to physical address conversion. 

PTV specifies physical to virtual address conversion. 

ADR, L *]address specifies the location of the ad- 
dress to be converted. 

M:MAP should be used with M:HOLD since the address 
returned via M:MAP may not be valid if a swap occurs. 

Calls generated by the M:MAP procedure have the form 
CAL1,6 fpt 

where fpt points to word of the FPT shown below. 

word 



X'02' 



Address 



0)23 14 56 718 ? 10 111 12 13 14 151 16 17 18 19l20 21 22 23 1 24 25 26 27 1 28 29 30 31 



word 1 



f 



1 2 3 14 5 6 7 I 8 9 10 111 12 13 14 15 [ 16 17 18 19 20 21 22 23 1 24 25 26 27l28 29 30 31 

where f indicates virtual to physical address conversion 
(f = 0) or physical to virtual address conversion (f = 1). 

If the user's privilege level is not at least A0, the return is 
to CAL+1 with CC1 set. 



MISCELLANEOUS REAL-TIME SERVICES 

The following is a set of services provided to master mode, 
mapped or unmapped real-time programs. These services 



are provided via Meta-Symbol procedure references that 
result in BAL linkages to monitor routines (hence the master 
mode requirement) as opposed to CALI linkages. The rou- 
tines entry points are REFed as a result of the various pro- 
cedure calls, therefore the program must be loaded with 
reference to the MONSTK or Jl files in order to satisfy 
these external references. All user registers are preserved 
by pushing them into TSTACK except as indicated for 
specific services. 



GET OR FREE PHYSICAL PAGE 

MlGPP The M:GPP procedure acquires a physical page 

of memory. The procedure call has the format 

M : GPP 

On return from the procedure, general register 3 contains 
the physical page number of the newly allocated page of 
memory or the value zero if none was available. 

In order for a mapped user to reference a physical page 
acquired by M:GPP, it is necessary to perform a Change 
Virtual Map (M:CVM) specifying the physical address of 
the page acquired by M:GPP and the virtual address into 
which this page is to be mapped. 



M:FPP The M:FPP procedure releases a physical page 

of memory that was acquired by M:GPP. The procedure 
call has the format 

M:FPP [*]page 

where page specifies the physical page number of a page of 
memofy which is to be returned to the system. 

It isthe user's responsibility toreturnany pages obtained via 
M:GPP since the system keeps no record of this transaction. 



INITIATE GHOST JOB 

M:GJ06 The M:GJOB procedure activates (or awakens) 

a program as a ghost job. The format of the procedure is 

M:GJOB (LMN,loc)[,(ACN,loc)][,(PRI, value)] 

where 

LMN,loc specifies the location containing the name 
of the program to be activated (or awakened) as a 
ghost job. The name must be in TEXTC format and 
must not be greater than 7 characters in length. If 
the name is less than four characters, a word of 
blanks (X'40's) must immediately follow the name. 

ACN, loc specifies the location containing the name 
of the account in which the program exists. The 
account name must be in TEXT format, left-justified 
with trailing blanks to occupy two words. The 
default is the :SYS account. 
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PRI, value specifies the execution priority to be 
associated with the ghost job. The default priority 
will be that defined for ghost jobs at SYSGEN. 

On return, CC1 is set if the named program was not found 
or was already active but not asleep. Otherwise, the con- 
dition codes are set to zero. 



GET AND RELEASE DISK GRANULE 

M:GDG The M:GDG procedure dynamically acquires 

a disk granule. The procedure has the format 

M:GDG 

The starting disk address of the acquired granule is returned 
to the user in general register 8 in the following format 



1 2 3 14 5 6 7 



DCTX 



9 10 11112 13 14 15 



RSN 



16 17 18 19120 21 22 23124 25 26 27128 29 30 31 



The disk address shown above is in standard format for disk 
addresses in CP-V, where: 

E is the extension bit necessary to represent a 
17-bit relative sector number on large capacity 
disk packs. 

DCTX is the DCT index for the device. 



To load or store a relative sector number: 

(LSECTA 1 
ISTSECTAJ 

where 



, oddreg [*J loc[, index] 



oddreg is the odd numbered register to be loaded 
or stored. 

loc and index are as described under LDCTX/ 
STDCTX. 



M'.RDG The M:RDG procedure dynamically releases a 

granule acquired via M:GDG. The procedure has the format 

M:RDG [*]disk address 

where disk address is the starting address of the disk granule 
to be returned to the system. It must have the same format 
as described for M:GDG. 

Under certain conditions, the monitor may not be able to 
accept a granule from the user at a particular time. In this 
case, register 8 will contain a zero indicating that the user 
must try again. 

Note that it is the user's responsibility to return any gran- 
ules obtained via M:GDG since the system keeps no record 
of this transaction. 



RSN 



is the 16-bit relative sector number. 



If ho granule is available, register 8 is set to zero. 

Note: Currently, E (in the disk address shown for M:GDG 
is a single bit). In the future Xerox may add disk 
packs which require 18— bits in order to represent 
the highest relative sector number. Therefore it is 
recommended that users utilize the following pro- 
cedures (referenced via the SYSTEM UTS directive 
of Meta-Symbol) when referencing disk address 
fields. 

To load or store a DCT index, use 

{sTDCTx}' r H loc[ ' index ^ 

where 

r is the register to be loaded (stored). 

loc is a location, or optionally, a pointer to a 
location, containing (destined to contain) the 
disk address (see index below). 

index is an index register containing a word dis- 
placement which, when added to the address 
given by loc, yields an effective address contain- 
ing (destined to contain) the disk address. 



REPORT USER EVENT 

M:RUE The M:RUE procedure reports an event on a 

particular user (i.e., it simulates that the event took place 
for the user). The format of the procedure call is 



M:RUE (UN,[*]user#),(EV,( 



eventl 
l*loc 2 J 



where 



user* is the number of the user for whom the event 
is to be reported. A user may determine his own 
user number (for purposes of communicating this 
to other programs) by referencing the monitor cell 
S:CUN (Current User Number) which is located in 
page of the monitor and is therefore available 
to any user program. 

event is one of the following symbols signifying the 

event to be reported on the user: 



Symbol 


Event 


Resulting Action 


E:CBK 
E:OFF 


BREAK 
Log-off 


Control passes to the user at 
the address specified via an 
M:INT procedure call. 

The user is deleted from the 
system. 
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Symbol 


Event 


Resulting Action 


E:ERR 


Error 


The user is errored and de- 
leted from the system. 


E:WU 


Wake-up 


The specified user is scheduled 
for execution and reentered 
at the instruction following 
the M:WAITCAL1. 


E:UQA 


Unqueue 


The specified user is scheduled 




for 


for execution and reentered 




access 


at the instruction following 
the CAL1 which caused him 
to be queued for access. 



loc2 is a word location containing the value as- 
sociated with the event symbol (defined by the 
assembly SYSTEM). 

Note: Care must be taken to ensure that the user for whom 
the event is being reported is in the appropriate 
state since an illegal current state/event combi- 
nation will cause the system to crash. E:CBK, 
E:OFF, and E:ERR may be safely reported on a user 
at any point in time. 



CHECK INTERRUPT STATUS 

M-.CHKINT The M:CHKINT procedure checks the status 

of an interrupt. The format of the procedure call is: 

M:CHKINT (INT,[*]int) 

where int is the location of a word containing the address 
of the interrupt to be checked. 

The following word of information will be returned to the 
user in general register 8: 



STAT 



USER 



6 1 2 1 I 4 4 i > I 8 ? 16 11 1 12 13 14 15116 17 18 l?l 20 21 22 23 1 24 25 26 27 1 28 29 30 3 



GJOB# 



where 



A specifies, if set, that the interrupt is armed. 

E specifies, if set, that the interrupt is enabled. 

T specifies, if set, that the interrupt has been 
triggered and the interrupt processing routine has 
not yet finished. 

STAT indicates the status of the task associated 
with the interrupt location as follows: 

STAT Meaning 

X'80 1 Task is active. 

X'40' Task is asleep or queued for interrupt. 



STAT Meaning 

X'20' Task is waiting for I/O completion. 

X'10' Task is blocked, waiting for a resource. 

X'01' Specified interrupt is not currently as- 
sociated with any user (i.e., inactive). 

USER is the internal user table index for the user 
currently associated with this interrupt. 



I/O SERVICES 

The following services result in BAL linkages to the monitor's 
I/O Supervisor module (IOQ). They are separated into 
three types: 

1. I/O without a DCB where the user supplies the channel 
program (M:EXCP). This should be used only where no 
handler exists for a particular device or the user re- 
quires unusual control over the device. 

2. I/O without a DCB while not requiring the user to build 
his own channel program (M:NEWQ). 

3. I/O with parameters supplied ina pseudo DCB (M:QUE). 

Special problems exist when applying these techniques to 
disk I/O. Unless the volume is being managed entirely by 
the user, the user must be aware of the physical location 
of the data on the disk volume (or volumes). A random file 
would be the most common way of allocating space on a 
public or private volume for use by both privileged and non- 
privileged users. A random file is allocated contiguously 
on a public or private volume when it is opened. By speci- 
fying the FPARAM option on the M:OPEN call to an exist- 
ing file, the user requests the monitor to pass the file attri- 
bute (FIT table) parameters to a specified location (see the 
DCB discussion in Appendix A of the CP-V/BP Reference 
Manual, 90 17 64). FDA (First Disk Address) is returned in 
word one of the X'OC — coded FIT entry. File size (in 
granules) is given in word one of the X'OD 1 — coded FIT 
entry. 

Flawed tracks are automatically taken care of by the I/O 
system assuming that the requested byte count does not cause 
the transfer to cross a track boundary from a good track to 
a flawed track. If the user ensures that all tracks are good, 
the hardware will automatically handle the case in which a 
track boundary is crossed. However, the user must handle 
the cylinder overflow condition himself. (A new seek must 
be issued between accessing the last sector of one cylinder 
and the first sector of the next cylinder. ) 



CALCULATING PHYSICAL ADDRESSES 

All of the I/O procedure calls described below are avail- 
able to the mapped or unmapped user. Several require that 
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physical addresses by passed. For all mapped users, the 
user may convert a virtual address to a physical address by 
using the M:MAP procedure call described previously. 

In order to ensure that a mapped user is not swapped between 
the time that the physical address is calculated and the 
time the I/O is requested, the M:HOLD (Lock in Core) 
service should be performed. 

Note, however, that a mapped, master mode program is 
assured of not being swapped as long as it does not request 
any monitor services via CALls. 



EXECUTE CHANNEL PROGRAM 

M:EXCP The M.-EXCP procedure causes the user's own 

channel program to be executed. The format of the pro- 
cedure call is 



M:EXCP (CPA,{^ loc) ]),(DCT, [*]index)- 



[,(PRI, [*]priority)][,(EA,[*]loc 
■[/Meai])][,(TOI,[*]value)] 



where 



DA(loc) specifies the physical doubleword address 
of the start of the channel program. 

*loc specifies the word address of a word which 
contains the physical doubleword address of the 
start of the channel program. (The asterisk is 
required.) 

DCT, [*]index is the DCT index of the device 
associated with the channel program. 

PRI, [*]priority is the priority to be associated 
with the requested I/O operation. Priority re- 
quests range from to X'FF' (highest to lowest). 
Priorities in the range of to X'BF' are treated 
as real-time priority requests; X'CO' to X'FF' are 
treated as background priority requests. The only 
system I/O that operates at a real-time priority 
is swapping I/O (priority = X'10'). The default 
priority is X'FF'. 

EA, [*]loc is the physical address of the user's 
end-action routine. 

eai is a word of end-action information. This 
information is passed back to the user's end-action 
routine. 

TOI, L*J value is a time-out value specified in 
five second increments. The default value is 
five seconds. 



The user's end-action routine (if specified) is entered 
unmapped, via a BAL on register 11. All registers may be 
considered volatile (except register 11, through which re- 
turn is made to the monitor). The following information is 
passed to the end-action routine: 



Register 




Bit Fields 


Contents 


7 




24,8 


-,DCT 


12 




8,8,16 


TYC, -, RBC 


13 




16,16 


-,CCA 


14 




32 


EAI 


15 




13,19 


-,BUF 


where 








DCT 


is the 


DCT index. 





TYC is the type of completion code returned by 
the device handler. 

RBC is the remaining byte count. 

CCA is the current IOP command address. 

EAI is the end-action information specified in the 
procedure call. 

BUF is the doubleword address of the start of the 

channel program command list specified by the 
M:EXCPcall. 

The end-action routine may obtain the complete TDV status 
by referencing the doubleword table DCT13 using the DCT 
index in register 7. 

CALL NEWQ 

M:NEWQ The M:NEWQ procedure requests I/O to be 

performed without a DCB and without a user' built channel 
program. The format of the procedure call is 



M:NEWQ [^ w jJ (FC, [*]code), 



. (BUF/ |BA(loc)j )/(SIZ/Wva|ue); . 



f, (DA, [*]disk addresser , ppT m . , 

I, (DCT, [*]index) J [ ' < PM ' Mpnor.ty)]; 



3 



-[,(NRT, Hvalue^] ,[,(EA, [*]loc 2 [, [*]eai] 



where 



W/NW is the WAIT/NO-WAIT option. The un- 
mapped user always does I/O with NO-WAIT. This 
implies that the unmapped user should always (ex- 
cept for unusual cases) specify an end^action ad- 
dress in order to ascertain when the I/O has com- 
pleted. The mapped user will do I/O with WAIT 
unless otherwise specified by the procedure call. 
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FC, [*]code is the function code which defines (to 
the device handler) the type of I/O operation to 
be performed. See discussion of function codes 
below. 

BUF,BA(loc) specifies the byte address of the 
user's buffer to be used in this I/O operation. 

BUF, *loc specifies the word address of a word 

which contains the byte address of the user's 
buffer. 



SIZ, value is the byte count to be used in this I/O 
operation. 

DA, [*]disk address specifies, for random-access- 
device operations only, the disk address to be used 
in this I/O operation. Disk addresses are of the 
format described under the discussion of the 
M:GDG procedure call. 

DCT, [*]index specifies for non-random -access- 
device operations only, the DCT index of the 
device to be used in this I/O operation. 

PRI, [*]priority is the priority to be associated with 
the requested I/O operation. See the description 
of priority under the discussion of M:EXCP. 

NRT, [*]value is the number of recovery tries to 
attempt before declaring an error. 

EA, [*]loc is the physical address, or optionally a 

pointer to a location containing the physical 
address, of the user's end-action routine. 

eai is a word of end-action information. See the 

end-action description under the discussion of the 
M:EXCP procedure call. The only difference is 
that BUF is the byte-address of the user's buffer 
as supplied by the MrNEWQ procedure call. 

To assist the user in determining the correct function codes 
to be used with the M:NEWQ procedure calls, the follow- 
ing is a discussion describing the function codes of the ex- 
isting device in the system. 



Typewriter Handler. The typewriter handler accepts the 
following function codes: 

- read with editing 

1 - write 

2 - write with device name 

3 - read without editing 

4 - read with editing and retry 

5 - write new line character 

6 - write with device name tabbed 



RAD Handler. The RAD handler accepts the following 
function codes: 

- seek-read 

1 - seek-write 

2 - sense 

3 - seek-checkwrite 

4 - seek-write, seek-checkwrite 

Error recovery on the RAD generally amounts to redoing the 
same operation when an error has been detected. One ex- 
ception is when a checkwrite is being performed fora write 
and an error is indicated. In this case, the write is done 
over, followed by another checkwrite. Checkwrites are 
performed for all writes if sense switch 1 is set on the op- 
erator's console. Special conditions checked for are write 
violation and illegal seek address. 



9-Track Tape Handler. The 9-track tape handler accepts 
the following function codes: 

- read 

1 - write 

2 - read reverse 

3 - write tape mark 

4 - backspace record 

5 - forwardspace record 

6 - backspace file 

7 - forwardspace file 

8 - rewind 

9 - sense 

10 - correctable read recovery 
1 1 - noncorrectable read recovery 

12 - write recovery 

13 - correctable read reverse recovery 

14 -. noncorrectable read reverse recovery 

15 - write tape mark recovery 



7-Track Tape Handler. The 7-track tape handler accepts 
the following function codes: 

- read packed 

1 - write packed 

2 - read reverse packed 

3 - write tape mark 

4 - backspace record 

5 - forwardspace record 

6 - backspace file 

7 - forwardspace file 

8 - rewind 

9 - read binary 

10 - write binary 

11 - read reverse binary 

12 - read decimal 

13 - write decimal 

14 - read reverse decimal 

15 - read packed recovery 

16 - write packed recovery 

17 - write tape mark recovery 

18 - read binary recovery 

19 - write binary recovery 
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20 - read decimal recovery 

21 - write decimal recovery 

22 - final backspace record for reverse read 

23 - final backspace record if unrecoverable error 



Card Reader Handler. The card reader handier accepts 



the following function codes: 

- read binary 
2 - read automatic 



Line Printer Handler. The line printer handler accepts 
the following function codes: 

1 - write without format 
3 - write with format 



Paper Tape Handler (PTAP). The paper tape handler ac- 
cepts the following function codes: 

0- read automatic 

1 -write BCD 

2 - read count 

3 - write binary 

4 - read direct 

5 - write direct 

6 - read BCD 

7 - read binary 



Card Punch Handlers. The card punch handlers accept the 
following function codes: 

- punch BCD 

1 - punch binary 



Disk Pack Handler (DPAK). The disk pack handler uses the 
following function codes: 

- seek-read 

1 - seek-write 

2 - sense 

3 - seek-checkwrite 

4 - read 

5 - write 

6 - checkwrite 

7 - restore 

8 - seek-read header 

9 - read header 



CALL QUE 

M:QUE The M:QUE procedure requests that I/O be 

performed through parameters supplied in a specified DCB. 
At the time of the call, the specified DCB need only be 
9 words in length but must contain valid information in the 
following fields: NRT, QBUF, BLK, and CDA. (See 



Appendix A of the CP-V/BP Reference Manual, 90 17 64. ) 
The format of the M:QUE procedure call is 

M:QUE [*]dcb, (FC, [*]code)[,(EA, [*]loc[, [*]eai])] 

where 

deb specifies the DCB associated with the re- 
quested I/O operation. 

code is an 8-bit code (described in Figure 17 be- 
low) which defines (to the device handler) the 
type of I/O operation to be performed. The code 
may be expressed as a decimal number or as a 
hexadecimal number in the format X'dd'. 

loc and eai function exactly as described under 
the discussion of the M:EXCP procedure Call. 
The user's end-action routine (if specified) will 
be entered unmapped via a BAL on register 1 1 
after the TYC (type of completion code) and ARS 
(actual record size) have been entered into the 
DCB. The following information is passed to the 
errchaction routine. 



Register 

6 

7 

8 

14 

where 



Bit Fields 

15,17 
24,8 
8,7,17 
32 



Contents 

-,BUF 
-, DCT 
FC, -, DCB 
EAI 



BUF is the word address of the user's buf- 
fer associated with this I/O request 

DCT is the DCT index as specified in the 
CDA field of the DCB at the time of the 
MrQUE procedure call. 

FC, DCB, and EAI are as specified in the 
M:QUE procedure call. 

For the unmapped user, the I/O will be queued at a priority 
of X'FF'. For the mapped user, the I/O will be queued 
based upon the user's current execution priority. 





1 2 3,4 


7 









DIR 


PACK 


FBCD 


Code 




V 


/here 






Code has the following meanings: 




- read BCD 




1 - read direct BCD 




2 -read binary 





Figure 17. I/O Operation Codes for Device 
Handler (M:QUE) 
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3 


- read direct binary 


4 


- write BCD 


5 


- write direct BCD 


6 


- write binary (write and format) 


7 


- write direct binary 


A 


- skip record forward 




B 


- skip record reverse 




C 


- skip file forward 


bits 1-3 are 


D 


- skip file reverse 


ignored for 
these codes 


E 


- rewind 




F 


- write end-of-file 




FBCD 


specifies no FORTRAN conversions 


if or FORTRAN conversions if 1. 


DIR 


specifies forward direction if or re- 


verse direction if 1. 


If the device is not 9T, 7T, or MT, only bits 5 


through 7 are meaningful. 



Figure 17. I/O Operation Codes for Device 
Handler (M:QUE) (cont.) 



SEND CHARACTER TO TERMINAL 

M:C0C The M:COC procedure sends a character to a 

user terminal. 



M^cBza-^pa^) 



where 



user* is the user number of the user whose terminal 
is to receive the character. 

line* is the line number of the terminal which is 
to receive the character. 

'character' is the EBCDIC character to be sent to 
the specified terminal. 

*loc[, ireg] specifies the address of a location 
which contains the character to be sent to the 
terminal (loc). (The asterisk is required but does 
not indicate indirectness.) The ireg field specifies 
an index register which contains the byte displace- 
ment which, when added to the address specified 
by loc, will yield the byte address of the char- 
acter to be sent to the terminal. If ireg is absent, 
loc is assumed to contain the left-justified char- 
acter to be sent to the terminal. 



DYNAMIC PHYSICAL PAGE ALLOCATION 
FOR REAL-TIME PROCESSING 

INTRODUCTION 

Physical pages are made available for real-time processing 
in either of two ways: 

• Dedication of physical core pages at boot-time. These 
pages are known as the Resident Foreground (RESDF) 
pages. SYSGEN parameters define the physical pages 
that are to be removed from the system and dedicated 
to real-time processing. These pages remain dedi- 
cated real-time pages until returned to the system by 
the operator, 

• Dynamic acquisition and release of physical core pages 
during normal operations. These pages are known as 
the Dynamic Resident Foreground (DYN RESDF) pages. 
The operator can acquire or release DYN RESDF pages 
by communicating with the Physical Page Stealer (PPS) 
ghost job. 

In both cases, foreground memory is allocated in 'memory 
segments'. A memory segment in this context is simply a 
set of contiguous physical pages. There is only one RESDF 
memory segment (i.e., that which may be allocated at 
boot-time). There may be several DYNRESDF memory 
segments, the maximum number of which is specified at 
SYSGEN time. All real-time memory segments must be 
allocated in the area between 64K and the end of physical 
core. 



The operator, by communicating with the Physical Page 
Stealer ghost job, has control over the allocation of both 
RESDF and DYNRESDF pages. The operator also has the 
ability to reset the SYSGEN defined RESDF size and maxi- 
mum DYNRESDF size thus affecting the system's maximum 
user size. Increases to RESDF size or to maximum DYN- 
RESDF size cause a decrease of the maximum user size; 
decreases to RESDF size or the DYNRESDF size cause the 
maximum user size to be increased. By setting the maxi- 
mum number of real-time pages that may be allocated to a 
minimum, the operator is able to allow very large jobs to 
be scheduled. Decreases to the maximum real-time page 
values may be effected at any time. Increases are limited 
to times when there are no users on the system other than 
system ghosts, i.e. , the system must be quiescent except 
for ALLOCAT, RBBAT, FILL and the PPS ghosts. Neither 
RESDF nor DYNRESDF maximum size may be increased to 
the point where the maximum user size is too small to 
allow the system ghosts to run. 



SYSGEN CONSIDERATIONS 

The system parameters that define the pages to be allo- 
cated at boot-time, the maximum number of pages that may 
be dedicated for real-time use, and the maximum number 
of memory segments that may be allocated for real-time 



\ 



136 Dynamic Physical Page Allocation for Real-Time Processing 



processing may be specified via options, of the :FRGD 
command of PASS2. The format of these options is as 
follows: 

(RES DF, size, address) 

where 

size specifies, in decimal, number of pages, the 
default size of the dedicated foreground memory 
area to be allocated at system initialization. 

address specifies, in hexadecimal, the word ad- 
dress of the first page in the RESDF memory seg- 
ment. This value must be equal to or greater 
than 10,000i6. 

Both size and address may be overridden by the operator at 
system initialization. Both parameters may be reset via 
communication with the Physical Page Stealer ghost job. 

(DYN RESDF, pages, segments) 

where 

pages specifies in decimal the maximum number of 
pages that may be dynamically allocated for fore- 
ground use. These pages are not removed from 
the system until requested, but the maximum user 
size is reduced by the value specified. This value 
may be altered by the operator via the PPS ghost. 

segments specifies in decimal the maximum number 
of dedicated real-time memory segments that may 
be allocated for foreground use. The default 
value is one. 



Either value may be omitted, or a response of NEW LINE 
alone may be used to request the SYSGEN-defined default 
for the omitted value(s). 



THE PHYSICAL PAGE STEALER GHOST JOB (PPS) 

The Physical Page Stealer ghost job is used for the manage- 
ment of all dedicated foreground memory. It is loaded for 
execution via the following keyin: 

!GJOB PPS 

PPS then asks the operator for a command: 



PPS: ENTER COMMAND 



The operator may respond with one of the following commands: 

Dl[SPLAYj Display memory segments currently 

allocated. 

GE[T] yyy,xxxxx Get DYN RESDF pages. 

FR[EE] yyy,xxxxx Free DYN RESDF pages. 

DY[N RESDF] yyy Reset maximum number of DYN- 
RESDF pages. 

RE[SDF] [yyy][, xxxxx] Redefine the RESDF area. 

EN[D] Exit ghost job. 



INITIALIZATION 

When a real-time system is booted from a system tape and 
operator console interaction is requested, or when a real- 
time system is booted from the system RAD, the following 
message is output on the OC device: 



RESET RESDF YYY, XXXXX? 



This allows the operator to override the SYSGEN-defined 
values for the beginning of the RESDF area and/or the size 
of the RESDF area. The operator should respond as follows: 

[yyy] [, xxxxx]© 

where 

yyy is the number of pages in decimal to be in the 
RESDF area. A value of through 999 may be 
used. 

xxxxx is the word address in hexadecimal of the 
first page in the RESDF area. A value greater 
than 10,000 16 (64K) must be used. 



where 



yyy 



specifies in decimal the number of pages. 



xxxxx specifies the word address in hexadecimal 

of the first page in the real-time memory seg- 
ment. This value must be equal to or greater 
than 10,000 16 . 

PPS will attempt to perform the requested function, type 
an error message if the function cannot be performed, and 
reprompt the operator to get the next command. The END 
command is used to terminate PPS processing. 

If the format of the command is in error, such as missing 
parameters, bad delimiters, etc., PPS will type '??' and 
reprompt the operator to reenter the command. 

The following message will be displayed if the number of 
pages specified is in error: 



EXPRESS # OF PAGES IN DECIMAL 0-999 



Dynamic Physical Page Allocation for Real-Time Processing 137 



The following message wi 1 1 be displayed if the page address 
specified is in error: 



EXPRESS PG ADDR IN HEX 10,000-xxxxx 



where xxxxx is the word address of the last page of physi- 
cal core. 



Since the operator is the only one who is allowed to com- 
municate with the PPS ghost, running PPS is not allowed 
from on-line or batch. If attempting to run PPS other than 
as a ghost job, the following message will be typed: 



MUST BE EXECUTED AS A GHOST JOB 



The PPS commands are described in detail in the following 
paragraphs. 



DISPLAY The DISPLAY command is used to obtain 

information concerning allocated real-time pages and the 
current settings of system parameters that define the maxi- 
mum real-time pages allocation. 

The following information is output on the OC device: 

MAX DYNRESDF - yyy 
CURRENT DYNRESDF - yyy 
DYNRESDF SEGMENT yyy xxxxx 
RESDF SEGMENT yyy xxxxx 
MAXIMUM USER CORE = yyy 

where 

yyy is the decimal number of pages. 

xxxxx is the hexadecimal word address of the first 
page in the real-time memory segment. 

The DYNRESDF SEGMENT message is repeated for each 
currently allocated DYNRESDF memory segment. 

GET The GET command is used to allocate DYNRESDF 

pages. This command may be used at any time and has no 
effect on the maximum user size. The format of the 
command is 

GE[t] yyy, xxxxx 
where 

yyy specifies in decimal the number of pages. 

xxxxx specifies the word address in hexadeci- 
mal of the first page in the real-time memory 
segment. This value must be equal to or greater 
than 10,000. ' 



The PPS ghost first validates that it is valid to allocate 
DYNRESDF pages. If the maximum number of DYNRESDF 
segments has already been allocated, the following mes- 
sage is displayed: 



MAXIMUM DYNRESDF SEGMENTS ALLOCATED 



If the allocation of the DYNRESDF memory segment would 
cause the number of DYNRESDF pages to exceed the maxi- 
mum allowed, the following message is displayed: 



EXCEEDS DYNRESDF 



The PPS ghost then validates that the pages specified are 
available. If the pages are currently being used by the 
monitor, (i.e., for transaction processing), the following 
message is typed: 



PAGES IN USE BY MONITOR 



If some or all of the pages specified are allocated as RESDF 
or DYNRESDF pages, the following message is typed: 



PAGES ARE REAL TIME PAGES 



The DISPLAY command should be used to determine the 
current allocation of real-time memory segments. 

If the pages cannot be obtained for any other reason, the 
following message is typed: 



UNABLE TO OBTAIN PAGES 



Otherwise, the pages specified are removed from the system 
and the operator is prompted to enter the next command. 

FREE The FREE command is used to return currently 
allocated DYNRESDF pages to the system. This command 
may be used at any time and has no effect on the maximum 
user size. 

The format of the command is 
FR[EE] yyy, xxxxx 



where 



yyy specifies the number of pages in decimal. 

xxxxx specifies the word address in hexadecimal of 
the first page in the real-time memory segment. This 
value must be equal to or greater than 10,000.,. 
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DYNRESDF memory segments cannot be partially released. 
That is, all pages within the memory segment must be 
released with one FREE command. If the pages specified 
are not totally contained in one memory segment, or the 
entire memory segment was not specified, the following 
message is displayed: 



NOT A DYNRESDF MEMORY SEGMENT 



The display command should be used to determine the 
currently allocated DYNRESDF segments. 

If the segment specified is valid, the pages will be returned 
to the system and the operator will be prompted to enter 
the next command. 



DYNRESDF The DYNRESDF command is used to re- 

define the maximum number of pages that may be removed 
from the system to be used as dynamic RESDF pages. No 
pages are obtained or released as a result of this command. 
This command alters the maximum user size. 

The format of the command is 
DY[NRESDF] yyy 

where yyy specifies the number of pages in decimal. 

The value specified is compared to the current setting of 
maximum number of DYNRESDF pages. If attempting to 
increase the maximum size, the system must have no users 
other than system ghosts. If other users are on the system, 
the following message is typed: 



SYSTEM ACTIVE 



The maximum user size will be decreased by an amount 
equal to the increase in maximum DYNRESDF pages. PPS 
checks to determine that the system ghosts would be able 
to tolerate the decrease in user size. If not, the following 
message is displayed: 



DON'T LOCK OUT SYSTEM GHOSTS 



Otherwise/ the maximum number of DYNRESDF pages that 
may be allocated is reset as specified and the maximum 
user size is decreased by the amount of increase to maxi- 
mum DYNRESDF pages. 

If attempting to decrease the maximum number of DYNRESDF 
pages, the value specified must be equal to or greater than 
the number of DYNRESDF pages currently allocated. If 
not, the following message is displayed: 



Otherwise, the maximum number of DYNRESDF pages that 
may be allocated is reset as specified and the maximum 
user size is increased by the amount of decrease to maxi- 
mum DYNRESDF pages. 



RESDF The RESDF command is used to redefine the 

RESDF memory segment. The RESDF command may be used 
to release all RESDF pages to the system or to obtain RESDF 
pages. 

The format of the command is 
RE [S DF][yyy][, xxxxx] 

where 

yyy specifies the number of pages in decimal. 

xxxxx specifies the word address in hexadecimal 
of the first page in the real-time memory seg- 
ment. This value must be equal to or greater 

than 10000,,. 
lo 

To release all RESDF pages, the following format should be 
used: 

RESDF 



This will cause all RESDF pages to be returned to the sys- 
tem. The maximum user size will be increased by the 
RESDF size. 



If the RESDF memory segment is not currently allocated 
when this format of the RESDF command is used, the fol- 
lowing message is displayed: 



NO RESDF PAGES ALLOCATED 



To re-establish the RESDF memory segment, the following 
format of the command should be used: 

RESDF [yyy] [, xxxxx] 

If either the number of pages or the word address of the 
first page is not specified, the previous value of the param- 
eter is used. 

If the RESDF segment is currently allocated, the following 
message is typed: 



RESDF PAGES ALREADY ALLOCATED 



CURRENT DYNRESDF PAGES > NEW MAXIMUM 



When this format of the RESDF command is used, the maxi- 
mum user size will be decreased by an amount equal to the 
size of the RESDF segment to be allocated. Therefore, 
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there must be no users on the system other than system 
ghosts and the system ghosts must be able to tolerate the 
decreased user size. Checks are also made to determine 
if the pages specified are available as described under the 
discussion of the GET command. 

Otherwise, the pages specified are removed from the 
system and the maximum user size is decreased by an 
amount equal to the number of pages in the RESDF memory 
segment. 



END The END command terminates PPS processing and 

has the format 



en[d] 



MONITOR DEFs 

The following words are DEFed in the monitor root and may 
be used by the real-time programmer to gain information 
concerning the current allocation of real-time pages. 



RESDF 



RESDFP 



DYNRESDF 



MDYNRESDF 



PP:UPPC 



The size of the RESDF area currently 
allocated. If all RESDF pages have 
been returned to the system, the 
value is zero. 

The word address of the first page in 
the RESDF area. 

The number of DYNRESDF pages 
currently allocated. 

The maximum number of DYNRESDF 
pages that may be allocated. 

The total number of RESDF and 
DYNRESDF pages currently a I located. 



RESDF MEMORY CAL 

The real-time user may obtain information from the monitor 
concerning the current allocation of real-time memory 
segments by issuing the following CAL: 

CAL 1,5 fpt 

where fpt points to word of the FPT shown below. 

word 



X'lB' 



Word address of first page 



■5 I 2 3 I 4 5 6 7 I 8 9 10 111 12 13 14 15 1 16 17 18 19(20 21 22 23 1 24 25 26 27 1 28 29 30 31 



word 1 



Number of pages 



1 2 3 14 5 6 7 I 8 9 10 11112 13 14 15116 17 18 19120 21 22 23124 25 26 27128 29 30 31 

The system checks to see if the set of pages specified in the 
FPT are currently allocated real-time pages. On return 
from the CAL, the condition code setting will be as follows: 



1 2 3 A 




The pages specified are the RESDF 
segment. 



1 The pages specified are a DYNRESDF 

segment. 

10 All pages are currently allocated 

real-time pages but are not a speci- 
fic memory segment. 

10 Some, but not all of the pages are 

currently allocated real-time pages. 

10 None of the pages are currently 

allocated real-time pages. 
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10. TRANSACTION PROCESSING FACILITIES 



This chapter describes a procedure that was designed for 
use by Xerox in the development of the transaction pro- 
cessing facilities of CP-V. The procedure should never be 
included in any user-written programs. This chapter is 
intended for Xerox system programmers only. 



M:QUEUE PROCEDURE FORMAT 

In transaction processing, the flow of transactions and re- 
ports is controlled through a single queue by a program 
called the System Queue Manager. The System Queue 
Manager is part of the CP-V monitor. The M:QUEUE pro- 
cedure was developed for use in the System Queue Manager 
and requires transaction processing authorization (via the 
Super processor). 

The format of the M:QUEUE procedure is 



M:QUEUE 



L*J deb name 
Hlistloc 
H list id 



UNLOCK 

DEFINELIST 

PUT 

GET 

STATS 

PURGE 

LOCK 



^(option)]. 



where 



deb name specifies the name of the DCB for 
UNLOCK and LOCK requests. 

list loc specifies the location of the list of criteria 
pointersfor PUT, DEFINELIST, and STATS requests. 

list id specifies the id of a list for GET and PURGE 
requests. 

UNLOCK activates usage of the queue and de- 
fines the queue owner. 

DEFINELIST defines the criteria for subsequent 
GET requests (i.e., the GET lists). 

PUT enters a transaction or report into the queue. 

GET retrieves a transaction or report from the 
queue. 

STATS returns the status of a transaction or report. 

PURGE discards outstanding GET lists which are 
active for a given user and releases user-associated 
queue control tables. 

LOCK ensures that the user is the queue owner and 
locks the queue from further use. 



The basic options are as follows: 

LSIZE, [*J value specifies the size of the list for 

PUT, DEFINELIST, and STATS. 

BUF, [*Jaddress specifies the buffer address for re- 
turning aqueue entry for a GET request or for return- 
ing queue status information for a STATS request. 

BSIZE, [*J value specifies the size of the area de- 
fined by the BUF option. 

WAIT specifies that the caller wishes to wait for 

access to the queue prior to resuming execution. 

ECB, L*Jaddress specifies the address of an ECB to 
be posted when a queue event occurs. A queue 
event may be: the arrival of an entry to the queue 
which satisfies an active GET list; the availability 
of the queue (when the WAIT option was not indi- 
cated on the original queue request); or queue 
space availability. 

The following option is applicable only to the GET request: 

INDEX, L*J value specifies the word displacement 
within the GET list to start the search for a criteria 
match. 

The following option is applicable only to the PUT request: 

1 1 OW I specifies the priority for PUT requests. 

The following options are applicable only to the UNLOCK 
request: 

I NFW I specifies whether the queue is a new or 
existing file. 

BACKUP specifies that the queue is to be kept up- 
to-date on secondary storage, (i.e., whenever a 
queue block is modified in core it is to be written 
to disk). 

QPAGES, [*] value specifies the maximum number of 
core pages which can be used for queue blocks and 
queue manager work pages. 

QSAT, L*J value specifies the percentage of queue 
capacity for acceptance of high priority PUTs only. 

KEYMAX, [*] value specifies the maximum number 
of bytes required to contain any name (trancode) 
presented for enqueueing(l-13 may be specified). 

RECOVER specifies queue unlock for recovery mode. 
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The following option is applicable only to the STATS 
request: 

COUNT specifies that the number of occurrences 

in the queue of a specified criterion is to be re- 
turned in the second halfword of SRI. 



The following option is applicable only to the LOCK 
request: 

PAUSE specifies that the queue lock is temporary 
and current users may continue processing their 
current outstanding requests when the queue is 
unlocked. 



option ECB (P]) 



ECB address 



1 2 3 14 5 6 7 18 9 10 11112 13 14 15116 17 18 19120 21 22 23 1 24 25 26 27128 29 30 31 



I 14 17 18 19l20 21 22 23l24 25 26 27 1 2 



option Q PAGES (P2) 



1 8 9 10 III 



1 2 3 14 5 6 7 f8 9 10 11112 13 14 15 14 17 18 191 20 21 22 23f24 25 26 27128 29 30 31 



Number of queue 
, core pages 

Z3T242 



option KEYMAX (P3) 



* 


ft ft 


Key size 







1 2 3 1 4 5 6 7 Is 9 10 111 12 13 14 I5I 16 17 IB 1?1 20 21 22 23I24 25 


24 27l28 29 30 31 



option QSAT (P4) 



I I 4 5 6 7 I 



1 2 3 14 5 6 7 I 8 9 10 111 12 13 14 15114 17 18 19120 21 22 23 



Saturation % 



24 25 26 27128 29 30 31 



M:QUEUE FUNCTION PARAMETER TABLES (FPTS) 

Calls generated by the M:QUEUE procedure have the form 
CAL1,7 fpt 

where fpt points to word of an FPT. The code in the first 
byte of word is as follows: 

FPT Code Function 



X'06' 


UNLOCK 


X'07' 


DEFINELIST 


X'08' 


PUT 


X'09' 


GET 


X'OA 1 


STATS 


X'OB' 


PURGE 


X'OC 1 


LOCK 



The various FPT formats are described in the sections that 
fol low. 



QUEUE UNLOCK REQUEST 

The format of the FPT for the UNLOCK request is: 
word 



X'06' 



DCB address 



1 2 3145 6 7 18 9 10 11112 13 14 15116 17 18 19120 21 22 23124 25 26 27128 29 30 31 



word 1 














p 
i 


p 

2 


P 
3 


P 

4 


ft ft 


F 

4 


F 
3 


F 
2 


F 
1 










1 


2 


3 


4 5 6 7 Is 9 10 111 12 13 14 15 1 16 17 18 19I2O 21 22 23 


24 


25 


26 


27 


28 29 30 31 



where 



F , = 1 



F 2 =1 



F 4 =1 



means WAIT option specified, 
means BACKUP option specified, 
means NEW option specified. 

means RECOVER specified. 



QUEUE DEFINELIST REQUEST 

The format of the FPT for DEFINELIST is: 
word 



X'07' 



0- 



List address 



TTl 2 3 1 4 5 6 7 I 8 9 10 111 12 13 14 )5l 16 17 18 isl 20 21 22 23l24 25 24 27I 28 29 30 31 

word 1 







I 12 13 14 bIw 17 18 19 1 20 21 22 23lj 



1 2 3 14 5 6 7 18 9 10 11 1 12 13 14 Bl W 17 18 191 20 21 22 231 24 25 24 271 28 29 30 31 







where F, = 1 means WAIT option specified, 
option ECB (P]) 



I 8 9 10 111 



ECB address 



1 2 3 14 5 * 7 TB 9 10 III 12 13 14 151 16 17 It 19l» 21 22 23124 25 26 27128 29 30 31 



option List Size (P2) 






* 








List size 





1 2 ]|4 S 6 ;ll 9 10 1 


1 12 13 14 15 


» 17 18 19l20 21 22 23l24 25 24 27l2B 29 30 31 



QUEUE PUT REQUEST 



The format of the FPT for PUT is: 
word 



X'08' 



0- 



List address 



1 2 3 14 5 4 7 18 9 10 11112 13 14 15(16 17 18 19 1 20 21 22 23I24 25 26 27! 28 29 30 31 

word I 



I 8 9 10 111 



1 2 3 14 5 6 7 18 9 10 11112 13 14 15114 17 18 19120 21 22 23124 25 26 27128 29 30 31 







where 



F. = 1 means WAIT option specified. 



F_ = means low priority request. 
Fn ~ 1 means high priority request. 
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option ECB (Pi) 



* 



ECB address 



1 2 3 14 5 6 7 I 8 9 10 11 I 12 13 14 15l 16 17 18 191 20 21 22 23124 25 26 27128 29 30 31 



1 20 21 22 23I2 



option List size (P2) 







01 2314567189 10 TTT12 13 14 15 



List size 



16 17 18 19T20 21 22 23124 25 26 27128 29 30 31 



option BUF (Pft 



* 



Buffer address 



1 2 3 14 5 6 7 18 9 10 11 1 12 13 14 15 1 16 17 18 191 20 21 22 231 24 25 26 27 1 28 29 30 3 



I 24 25 26 27 1 2 



option BSIZE (P 3 ) 







■0 



Buffer size 



01 5 3 I 4 5 6 7 I 8 9 10 111 12 13 14 15116 17 18 19 1 20 21 22 23 1 24 25 26 27 1 28 29 30 31 



QUEUE GET REQUEST 

The format of the FPT for GET is: 
word 



* 










C\ c\ 








A"uy 


U U 


LIST ia 


1 2 3 14 5 6 7 

word 1 


8 9 10 111 12 13 14 15 


16 17 18 19l20 21 22 23l24 25 26 27 1 28 29 30 31 


p 
i 


p 

2 


P 
3 


P 
4 


n C\ 


F 

1 





U 


hr 


1 


2 


3 


4 5 6 7 


8 9 10 111 12 13 14 15 


16 17 18 19120 21 22 23124 25 26 


27 


28 29 30 31 



where F -| = 1 means WAIT option specified, 
option ECB (P]) 







ECB address 



(Pi 2 314 5 6 718 9 10 111 12 13 14 15116 17 18 19120 21 22 231 24 25 26 271 28 29 30 31 



option Index (P2) 



0- 



Index 



1 2 3 14 5 6 7 18 9 10 11112 13 14 15116 17 18 19120 21 22 23124 25 26 27128 29 30 31 



option Buffer address (P3) 



Buffer address 



I 16 17 18 I9I2 



1 2 3 14 5 6 7 18 9 10 11 1 12 13 14 151 16 17 18 191 20 21 22 231 24 25 26 271 28 29 30 31 



option Buffer size (P4) 




* 


0— — 


Buffer size 





1 2 3 1 4 5 6 7 1 8 9 10 111 12 13 14 15 


16 17 18 19l20 21 22 23l24 25 26 27 1 28 29 30 31 



QUEUE STATS REQUEST 

The format of the FPT for STATS is: 
word 



X'OA' 







List address 



~0 1 2 3 14 5 6 7 18 9 10 111 12 13 14 15 1 16 17 18 1?] 20 21 22 23 1 24 25 26 27 1 28 29 30 31 

word 1 



p 
1 


p 

2 


P 
3 


n n 


F 
2 


F 
1 





U u 





1 


2 


3 1 4 5 6 7 1 8 9 10 111 12 13 14 IS 1 16 )7 18 19I2O 21 22 23 1 24 25 


26 


27 


28 29 30 31 



where 

F2 = 1 means COUNT option specified. 

F] = 1 means WAIT option specified, 
option ECB (P]) 











ECB address 



1 2 3 1 4 5 6 7 I 8 9 10 111 12 13 14 15 1 16 17 18 19 1 20 21 22 23 1 24 25 26 27 1 28 29 30 31 



QUEUE PURGE REQUEST 

The format of the FPT for PURGE is: 
word 



X'OB' 







List id 



0-1.2 31456 718 9 10 11112 13 14 15116 17 18 19120 21 22 23124 25 26 27128 29 30 31 

word 1 . 



p 
1 


ft ft 


F 
1 


0—0 


U U 





1 2 3 U 5 6 7 1 8 9 10 111 12 13 14 15l 16 17 18 T9 1 20 21 22 . 23 i 24 25 26 


27 


28 29 30 31 



where F] = 1 means WAIT option specified. 
option ECB (P^ 



ECB address 



70 1 2 3 14 5 6 7 18 9 10 ill 12 "l3"T4"'i5'l 16 17 18 I9I2O 21 22 23 i 24 25 26 27 1 28 29 30 31 

QUEUE LOCK REQUEST 

The format of the FPT for LOCK is 
word 



* 


X'OC 





DCB address 


12 314 5 6 7 8 9 10 11112 13 14 15 1 16 17 18 191 20 21 22 23124 25 26 27128 29 30 31 

word 1 


p 
i 


ft ft 


F 
5 


0—0 


F 
1 


— 


U U 





12 3 1 4 5 6 7 


8 9 10 111 12 13 14 


151 16 17 18 19120 21 22 


23 


24 25 26 


27 


28 29 30 31 



Fi = 1 means WAIT option specified. 
Fc = I means PAUSE option specified. 

option ECB (Pi) 



0- 







ECB address 



1 2 3 I 4 5 6 7 I 8 9 10 111 12 13 14 15 i 16 17 18 19 1 20 21 22 23 1 24 25 26 27 1 28 29 30 3 

LISTFORMAtS 

DEFINELIST OR STATS LIST 

The format of the DEFINELIST or STATS list is: 



Name 1 length 



Virtual byte address of criterion l 



1 2 3 14 5 6 .7 18 9 10 11112 13 14 15116 17 18 191 20 21 ,22 23124 25 26 27128 29 30 31 



Name n length 



12 3 14 5 6 7 



Virtual byte address of criterion 



9 10 111 12 13 14 151 16 17 18 19120 21 22 23 1 24 25 26 27128 29 30 31 
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The criterion is in TEXT format with periods, followed by a 
flag byte. At least one period must appear in the criterion 
name. (The format of criterion isdescribed in the CP-V/TP 
Reference Manual, 90 31 12.) 

The flag byte has the format 



5 D FfcS 

L 



01 2 3 14 5 6 7 

where 

F is set to one if failed entries are acceptable 
(i.e., the system is to GET the transaction re- 
gardless of whether or not it was successful). 

D is set to one if the entry is to be destroyed after 

it has been redd. 



GET MESSAGE 

The format of the GET message is: 



JI 



(Used by the queue manager) 



Length of entry 
text (bytes) 



Length of entry name 
(bytes) 



Entry name 



Entry text 



where 

Q indicates queued and is always set to one. 

F indicates failed, if set to one. 

JI are journalization indicators. Although these 
bits are kept in this status byte, the queue man- 
ager does not use this information. The informa- 
tion is stored here for use by other transaction 
processors. 

PUT LIST 

The format of the PUT list is: 



Flags 



Virtual word address of entry] 



TJ I J 3 I 4 5 6 7 f 8 * 10 Hlii 13 U tell* 17 18 19 1 30 21 22 23 1 24 25 26 i> i 56 it 30 31 



Flags 



Virtual word address of entry2 



1 2 3 14 5 6 7 18 9 10 11112 13 14 15116 17 18 19120 21 22 23124 25 26 27128 29 30 31 

where the entries are in journal record format. (See the 
GET message, above, for this format. ) 



The first four bits of the flags field have the following 
meaning: 

Q Z. I L 

- - 1 Delete in-progress entry. 

1 - Insert an entry into the queue. 

1-11 Mark an entry failed. 

1 - 1 Put an in-progress entry back into the 
queue. 

1 - 1 Insert a pre-failed entry into the queue. 

The JI field contains journalization indicators. Although 
these bits are kept in this status byte, the queue manager 
does not use this information. The information is stored here 
for use by other transaction processors. 



M:QUEUE PROCEDURE OUTPUT PARAMETERS 

SRI INFORMATION 

UNLOCK: Transaction id returned in SRI 



8-character hexadecimal transaction id 



1 2 3 14 5 6 7 I 8 9 10 111 12 13 14 15116 17 18 19120 21 22 23124 25 26 27128 29 30 31 



DEFINELIST: List-id returned in SRI 











Ol 4 digit hexadecimal list id 



i 2 3 I 4 5 6 7 Is 9 10 1 1 1 12 13 14 15116 17 18 IS"! 20 21 22 23 1 24 25 26 27I28 29 30 31 

GET: Word displacement within the list to the criterion for 
which an entry has been stored in the caller's buffer. 
The format of the entry itself is given in the List For- 
mats section. 

Displacement returned in SRI 







Word displacement 
1 -X'FFFF' 



1 2 3 I 4 5 6 7 I 8 9 10 111 12 13 14 15l 16 17 18 I9I2O 21 22 23I24 25 26 27 1 28 29 30 31 

PUT: Word displacement within an erroneous list to the entry 
in error. (The SRI format is the same as for GET.) If 
no errors occur, SRI is meaningless. 

STATS: The status of a queue entryand, optionally, a count 
of such entries are returned in SRI 



xxxx 



Entry count 



1 2 3 4 5 6 7 8 9 10 11112 13 14 15116 17 18 19120 21 22 23124 25 26 27128 29 30 31 

where 

Bit = 1 means entry queued. 

Bit 1 = 1 means reserved. 

Bit 2 = 1 means entry in failed status. 

Bit 3 = 1 means entry in progress, i.e., given to a 
TIC or TPC. 
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ECB INFORMATION 

ECB completion codes for a posted GET request are: 

X'OO' An entry is present. Request it. 

X'01 1 An entry has been placed in the caller's 
buffer. 

An unposted ECB indicates that a queue matching entry is 
unavailable. Error codes are returned in the ECB for re- 
quests using the ECB option. 

CONDITION CODE SETTINGS 

When the M:QUEUE procedure is performed, the following 
condition code settings may result: 

CC1 CC2 Status 

Normal return. 

1 - Queue unavailable or request cannot be 

satisfied. 

1 ECB wait is meaningful. 



QUEUE ERROR CODES 

Errors detected by the system Queue Manager result in 
error notification to the caller or a user abort. The error 
code for M:QUEUE CALs is X'BC. The code is communi- 
cated to the caller in SR3 and, if the ECB option is speci- 
fied, in the ECB. The code is contained in byte of SR3, 
a subcode is contained in bits 8-14, and the content of the 
FPT word 0, bits 15-31 is returned in the rightmost 17 bits 
of SR3. Therefore SR3 may contain the deb address, listloc 
or listid depending upon the queue request. The error sub- 
codes are listed in Table 44. 



Table 44. M:QUEUE Error Subcodes 



Table 44. M:QUEUE Error Subcodes (cont. ) 



Subcode 


Meaning 


01 
02 


Illegal queue service requested (e.g., 
an unlock is requested and the queue 
is not locked or the caller is not an 
authorized TP user). The task is 
aborted. 

An event not associated with the queue 
has occurred for the user (e.g. , M:INT, 
abort, ESCape or BREAK). 



Subcode 


Meaning 


03 


Error return from get physical work 
page (abort during unlock processing 
only). 


07 


Queue saturated; i.e . , index core space 
or queue secondary storage space is 
unavailable. 


08 


Queue lock or unlock caller does not 
have the required privilege. The task 
is aborted. 


09 


DCB not open for a lock or unlock 
request. The task is aborted. 


0A 


Space is not available to define a 
list. 


10 


Bad memory address. The task is 
aborted. 


11 


Queue locked. 


12 


Queue physical page space is not 
available. 


13 


Error in the list presented for a 
PUT, DEFINELIST, or STATS request. 


14 


Entry not found for a queue request 
requiring an existing entry. 


15 


I/O error during control/index transfer 
for an unlock request. The task is 
aborted. 


16 


I/O error during a data block 
transfer. 


17 


Queue busy. 


20 


Queue GET or PURGE request for a non- 
existent GET list. 
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APPENDIX A. OPERATIONAL LABELS 



Table A-1. Standard Operational Labels and 
Default Device Assignments 



Table A-2. Batch Assignment of Operational 
Labels 



Opera- 
tional 




On-Line 


Ghost 


Label 


Batch Device 


Device 


Device 


C 


Card reader 


Terminal 


Operator's 
console 


OC 


Operator's 


Terminal 


Operator's 




console 




console 


LO 


Line printer 


Terminal 


Line printer 


LL 


Line printer 


Terminal 


Line printer 


DO 


Line printer 


Terminal 


Line printer 


PO 


Card punch 


None 


Card punch 


BO 


Card punch 


None 


Card punch 


LI 


Card reader 


None 


Operator's 
console 


SI 


Card reader 


Terminal 


Operator's 
console 


BI 


Card reader 


None 


Operator's 
console 


SL 


Line printer 


Terminal 


Line printer 


SO 


Card punch 


None 


Card punch 


CI 


Card reader 


None 


Operator's 
console 


CO 


Card punch 


None 


Card punch 


AL 


Card punch 


None 


Card punch 


EI 


Card reader 


Terminal 


Operator's 
console 


EO 


Card punch 


None 


Card punch 


UC 


Operator's 


Terminal 


Operator's 




console 




console 



Device 


Oplabel 


Line printer 


LO, LL, DO, SL, LP 


Card reader 


C, LI, SI, BI, CI, EI, CR 


Card punch 


PO, BO, SO, CO, AL, 
EO, CP 


Operator's console 


OC, UC 


9-track magnetic tape 


9T 


7-track magnetic tape 


7T 


Default tape 


MT 


None 


NO, ME 



Table A-3. On-Line Assignment of Operational 
Labels 



Device 


Oplabel 


User's terminal 


C, OC, LO, LL, DO, SI, 




SL, EI, UC, ME, CR 


Card punch 


CP 


Line printer 


LP 


9-track magnetic tape 


9T 


7-track magnetic tape 


7T 


Default tape 


MT. 


None 


NO, PO, BO, LI, BI, SO, 




CI, CO, AL, EO, PR, PP 
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APPENDIX B. PHYSICAL DEVICE NAMES 



A physical device name is indicated by yyndd. 

where 

yy specifies the type of device (see Table B-l). 

n specifies the IOP letter for Sigma computers (see 
Table B-2)or cluster/unit for the Xerox 560 (see 
Table B-3). 

dd specifies the device number (see Table B-4), 
in hexadecimal. 



Table B-1. Standard I/O Device Type Codes 



Table B-2. Sigma IOP Designation Codes 



yy 


Device Type 


7T 


7-track magnetic tape 


9T 


9-track magnetic tape 


CP 


Card punch 


CR 


Card reader 


TY 


Typewriter 


LP 


Line printer 


DP 


Disk pack 


DC 


Magnetic disk 


ME 


CP-V terminal 


RB 


Remote processing data set 
controller 


XP 


Optical character printer 


MO 


Message mode communica- 
tions equipment 


MC 


Remote assist terminal 
(maintenance console) 



IOP 




Letter (n) 


Unit Address 


A 





B 


1 


C 


2 


D 


3 


E 


4 


F 


5 


G 


6 


H 


7 



Table 


B-3. 


Xerox 560 Cluster/Unit Matrix 




Unit 
Number 


Cluster Number 








1 


2 3 4 5 


6 


7 


A 


B 


H N T Z 


5 


* 


1 


$ 


C 


I O U 


6 


* 


2 


# 


D 


J P V 1 


7 


* 


3 


Q 


E 


K Q W 2 


8 


* 


4 


: 


F 


L R X 3 


9 


* 


5 


* 


G 


MS Y 4 


i I 


* 


6 


* 


* 


* * * * 


* 


* 


7 


* 


* 


* * * * 


* 


* 


* 
Reserved 



Table B-4. 


Device Designation Codes 


Hexadecimal 
Code (dd) 


Device 
Designation 


00 < dd < 7F 
80 < dd < FF 


Refers to a device number 
(00 through 7F). 

Refers to a device controller 
number (8 through F followed by 
a device number? through F). 
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APPENDIX C. CP-V SCREECH CODES 



Screech Code - 01 

Called From: SCHED, MM 

Message: USERS - PAGE CHAIN INCONSISTENT 

Registers: When called from SCHED: 

RO - if circular orunlinked chain; otherwise, the Link number index in chain. 

Rl - Link register. 

R2 - Next page chain link. 

R4 - User being scheduled. 

R7 - Address of Chain Head, Tail, and Count Table. 

SR4 - Offending page number. 

When called from MM (T:XPGVI): 

Rl - Zero. 

R3 .- Physical page number. 

R7 - Virtual page number. 

Remarks: The requested virtual page in the user virtual map chain (JB:LMAP) can't be found. SeeT:PGCHKin SCHED, 

Effective when SSI set. 



Screech Code -02 

Called From: SCHED 

Message: REPORTED EVENT INCONSISTENT WITH USER'S CURRENT STATE 

Registers: R3 - Previous state. 

R4 - User number (T:RE, T:RCE). 

R5 - User number (T:RUE). 

R6 - Event number. 

R7 - Line number (T:RCE). 

SR4 - Return address for reschedule. 

Remarks: The contents of R3 through R7 are dependent upon the called entry point. If R4 = S:CU, the call was T:RE. 

If R7 is the line number of the user in R4, the call was T:RCE. If R4 = R5, the entry is T:RUE. 



Screech Code - 0A 

Called From: DPSIO, TSIO 

Message: OPCODE IN SWAP COMMAND CHAIN IS INVALID 

Registers: Case 1, command list security checks — SS4 set: 

Rl - Incorrect command list order code if not equal to R3. 

R2 - Incorrect command list entry address (IOCD). 

R3 - Order code of first IOCD in command list. 

R4 - Swap device index. 

R6 - Command list beginning address. 

R7 - Swapper function code. 
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Case 2, Unrecoverable read error during inswap: 

Rl - Inswap user number. 

R7 - DCT index. 

SRI - Incorrect command list entry address (IOGD), 

Dl - Order code. 



Screech Code - OB 

Called From: DPSIO, TSIO 

Message: INCORRECT ORDER CODE IN SWAP COMMAND LIST 

Registers: 



Remarks: 



Rl - Incorrect order code; not seek. 

R2-R7 - See case 1 of screech code OA above. 

SS4 must be on for check . 



Screech Code - OC 

Called From: DPSIO, TSIO 

Message: ATTEMPT TO SWAP MONITOR'S MEMORY 

Registers: Rl - Buffer address . 

R2-R7 - See case 1 of screech code OA above . 

Remarks: SS4 must be on for check. 



Screech Code - OD 

Called From: TSIO 
Message : 



Registers: 



Remarks: 



HALT FLAGS MISSING IN SWAP COMMAND LIST 

RO - FLAGS byte from TIC command . 

Rl - TIC order code. 

R2-R7 - See case 1 of screech code OA above . 

SS4 must be set to check. FLAGS must not have command chaining set and must have interrupt-on-zero- 
byte-count or channel-end set. 



Screech Code - OE 

Called From: TSIO 

Message: 

Registers: 



Remarks: 



I/O REQUEST WITH NULL COMMAND LIST 



R4 - Swap device index. 

R6 - Command list beginning address. 

R7 - Swapper function code. 

Not checked for pack-only swappers. 
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Screech Code - OF 

Called From: DPSIO, TSIO 

Message: INPUT FUNCTION CODE IS INVALID 

Registers: R2 - Swapper function code. 

D4 - X'OF 1 . 

Remarks: SS4 must be on to check. Function code not between one and five exclusively. 



Screech Code 

Called From: 
Message : 
Registers: 

Remarks: 



COC, ECBBLK 

BAD COC BUF POOL, OR BAD BUF ADR ON RELEASE REQUEST 

R2 - Logical line number. 

R4 - Buffer address. 

R6 - Return address from buffer return call. 

1. On a COC buffer release, an invalid relative buffer address was specified (address 15 or HRBA*4+15). 

2. On a COC buffer GET or RELEASE, an invalid relative buffer address was found in the free pool chain. 
If the COC module was assembled with the COCGBUG and COCPBUG flags set (normally they're not), 
and sense switch 4 is set, the entire free pool chain is checked on each PUT and GET operation. (The 
R4 and R6 contents listed above are valid only at entry and exit times.) 



Screech Code 

Called From: 
Message : 
Registers: 



-11 



Remarks: 



COC 

INVALID INTERNAL CONTROL CODE TRANSLATE REQUEST 

Rl - DCB address. 

R2 - Line number. 

R5 - Character. 

R7 - Byte address of user buffer. 

SR2 - Return address. 

SR3 - Output translation table address. 

The cause is a translate table error (e.g., 2741 N/L on non-2741 line), or a bad input buffer chain. 
Rl, R7, and SR4 are not always set. 



Screech Code - 12 



Called From: 


COC 


Message : 


COC -BAD INPUT BUF LIN 


Registers: 


RO - Removal point. 

Rl - DCB address. 

R2 - Line number. 

R3 - COC number. 

R4 - Current release point. 



SR3 - Output translate table address. 
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Remarks: 



SR4 - Caller's return; RTN + 1 = activation. 
D3 - Return address. 

The COC input buffers are being released, and there is a conflict between the insertion and removal points 
and the chain. RO, Rl, R3, and R4 are not always set. 



Screech Code - 13 



Called From: 

Message: 

Registers: 



Remarks: 



COC 



COC - OUTPUT BUF LINKAGE OR CHARACTER COUNT BAD 

Rl - DCB address. 

R2 - Line number. 

R3 - COC number. 

R4 - Removal point (usually negative). 

R5 - Character. 

SR4 - Output count; usually = -1 . 



The output count and buffers are inconsistent. This may be caused by extended interrupt pulse or clobbered 
COC tables - usually COCOC, COCOI, or COCOR. Rl is not always set. 



Screech Code - 14 

Called From: THEUNCOC 

Message: COC ROUTINE CALLED IN NON-COC SYSTEM 

Registers: SR2 - BAL adr if 14-03. 

SR4 - BAL adr if 14-01 or 14-02. 
D4 - BAL adr if 14-04. 

Remarks: The subcode indicates which routine was called: 



14-01 


COCIO 


14-02 


COCOFF 


14-03 


COCSENDX 


14-04 


ECHOCR2 



Screech Code - 17 

Called From: IOQ 

Message: INVALID DISK ADDRESS PASSED FOR AN I/O INSTRUCTION 

Registers: Rl - IOQ7,R3 = DCTX = 0. 

R2 - DCB address. 

R3 - Queue index. 

SRI - Seek address from CDA,R2. 

D4 - X'17'. 

Remarks: Caused by an invalid DCT index. R2 and SRI are not always set. If the invalid address is on a RAD or disk, 

DSCVT will have been called and R2 and SRI will be set. 
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Screech Code - 19 

Called From: BUFF 
Message : 



INVALID BUFFER ADDRESS PASSED FOR RELEASE 



Registers: Rl -Index to BUFLIMS. 

R2 - Head of respective buffer pool. 

R5 -JIT address. 

SR4 - Link return address. 

D3 - Buffer address. 

D4 - X'19'. 

Remarks: Occurs both on releasing and acquiring buffers of most types (CPOOL, SPOOL, and MPOOL). 



Screech Cede - 1A 

Called From: CLS 

Message: ACCOUNT DIRECTORY INACCESSIBLE 

Registers: — 

Remarks: The account directory is bad and the monitor is unable to reconstruct it. All files are lost. 



Screech Cede — IB 



Called From: 

Message: 

Registers: 



Remarks: 



Swapper 

USERS PAGE CHAIN NON ZERO AT SWAP COMPLETION 

Rl - Inswap user number (S:ISUN). 

R2 - Physical byte address of JIT. 

R3 - UB:US,1 (user state). 

R4 - Physical page head. 

R5 - Physical page tail. 

R6 - Physical page count. 

SR4 - Cou;it of swapper free page chain (S:FPPC). 

Swappers' free page pool must be nonzero at end of inswap. S:FPPH, S:FPPT contain head and tail of pages 
just allocated to the inswap user. 



Screech Cede - 10 

Called From: T:OV 
Message: 

Registers: 



Remarks: 



REQUESTED OVERLAY NUMBER IS OUT OF RANGE 



R2 - Overlay name. 

R3 - Overlay name. 

R4 - 0. 

D4 - X'1D\ 

Requested monitor overlay is not in shared processor table. 
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Screech Code - IF 

Called From: SWAPPER 

Message: NOT ENOUGH PAGES TO PERFORM THIS SWAP 

Registers: R3 - Page to release. 

SRI - Deficient page count. 



Screech Code - 21 



Called From: 

Message: 

Registers: 



MM 



ATTEMPT TO SET ACCESS CONTROLS ON NON-EXISTENT VIRTUAL PAGE 



R6 - Number of pages to set. 
R7 - Virtual page number. 
SR4 - Link register. 



Screech Cede - 22 

Called From: TYPR 
Message: 



Registers: 



Remarks: 



PRIVATE VOLUME ALLOCATION ERROR 

R2 - SN count. 

R3 - DCB volume number. 

R4 - SYSID (0 = EXCLusive use). 

R6 - DCB address. 

SR4 - Return address. 

D2 - DCB:SNT. 

D4 - X'22'. 

Error in allocation. The specified entry in AVRTAB is not found or has bad flags. 



Screech Cede - 23 

Called From: CSE57, CSE59, CSEX560, CSECOM 

Message: INVALID ENTRY TO CSE HANDLERS 

Registers: — 

Remarks: Entry was made to an unused slot of the CSE branch vector for this machine. 



Screech Code - 24 

Called From: CSEHAND 



Message : 
Registers: 
Remarks: 



INSTRUCTION EXCEPTION TRAP IN MASTER MODE 



A trap X'4D' occurred while in the master mode. A slave mode trap causes a normal user job step abort. 
All relevant information is in the in-core error log buffer. 
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Screech Code - 25 

Called From: CSEHAND 



Message : 
Registers: 
Remarks: 



UNRECOVERABLE WATCHDOG TIMER TRAP 



Sigma 9 and Xerox 560 systems will attempt recovery from watchdog timer traps resulting from I/O instruc- 
tions without screeching. All relevant information is in the in-core error log buffer. 



Screech Code - 26 

Called From: CSEHAND 



Message : 
Registers: 
Remarks: 



CSE TRAP DURING MFI, PFI HANDLING 



During MFI handling on a Sigma 9 or during MFI or PFI handling on a Xerox 560, a CSE trap (X'46 1 , X'4C, 
X'4D') occurred. All relevant information is in the in-core error log buffer. 



Screech Code - 27 

Called From: CSEHAND 



Message : 
Registers: 
Remarks: 



PROCESSOR FAULT INTERRUPT 



A processor fault interrupt interrupt occurred for which continued operation is unlikely. All relevant infor- 
mation is in the in-core error log buffer. (Xerox 560 systems only.) 



Screech Code - 28 



Called From: 
Message : 
Registers: 
Remarks: 



CSEHAND 

MEMORY PARITY ERROR - MEMORY ALTERED 



A memory parity error correction caused memory to be altered. Continuation without recovery is not possible. 
Caused by interrupt X'56' on Sigma 6 or 7 or trap X'4C in Sigma 9 or Xerox 560. All relevant information 
is in the in-core error log buffer. 



Screech Code - 29-00 



Called From: 
Message : 
Registers: 
Remarks : 



CSEHAND 

TRAP 4C - BUS CHECK FAULT 



A Sigma 9 bus check fault or a Xerox 560 miscellaneous trap X'4C occurred while in the master mode. All 
relevant information is in the in-core error log buffer. 
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Screech Code - 29-01 

Called From: CSEHAND 



Message : 
Registers: 
Remarks: 



TRAP 4C - MAP PARITY ERROR 



A map register parity error occurred on a Sigma 9 or Xerox 560 while in the master mode. All relevant in- 
formation is in the in-core error log buffer. 



Screech Code - 29-02 

Called From: CSEHAND 



Message : 
Registers: 
Remarks: 



TRAP 4C - REGISTER BLOCK PARITY ERROR 



A register block parity error occurred on the Xerox 560 while in the master mode. All relevant information 
is in the in-core error log buffer. 



Screech Code - 29-03 

Called From: CSEHAND 



Message : 
Registers: 
Remarks: 



TRAP 4C - WRITELOCK REGISTER PARITY ERROR 



A write lock register parity error occurred on the Xerox 560 while in the master mode. AN relevant informa- 
tion is in the in-core error log buffer. 



Screech Code - 2C-00 

Called From: ADD 



Message : 
Registers: 



Remarks: 



BATCH SCHEDULING ERROR - MBS/CCI ERROR 

Rl - (S:CUN) current user number. 

R2 - Device type. 

R3 - Context block address. 

R5 - 0. 

R6 - User's DCB address (M:C). 

SR2 - OPNLD + .14. 

SR3 - Context block address. 

SR4 - OPNLD + .40. 

Dl - BA (OPNLD + .1E7) + .28. 

D2 - BA(CONTXT BLK + SCFQARGS) + .28. 

D3 - Device type mnemonic text. 

Register contents significantly different from above indicate the monitor wandered into GETI in ADD. Other- 
wise, a batch user has been created and has read a card before MBS selected him to be run. Actually all re- 
corded 2C's have been CO attempting to start a second job. Problem is either CCI read past FIN or a MBS/ 
GETI communication problem (e.g., GIB:UN clobbered). 
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Screech Code - 2D-00 

Called From: COOP 



Message: 
Registers: 



Remarks : 



COOPERATIVE BUFFER MANAGEMENT ERROR 

Rl - BUFLIMS index for screech code 19. 

R2 - .BC11. 

R3 - Context block. 

SR4 - COOP+ .18D. 

D3 - 0. 

At context block initialization a buffer was allocated for the context block. This buffer has been lost through 
core clobbering or mismanagement of a buffer chain. The particular user cannot continue. 



Screech Code - 2D-01 

Called From: COOP 

Message: SYMBIONT/COOP FILE DEVICE INACCESSIBLE 

Registers: R0 -COOP+.19B. 

Rl - Context block physical address. 

R4 - (DCT3(DCTX)) will appear in the format XXIX XXXX. 

SR4 - COOP+ .15C. 

Dl - .XXFF0300 + DCTX (X means could be any value). 

D2 - BA (COOP BUFFER). 

D3 - .400. 

D4 - Disk address. 

Remarks: The symbiont/coop file device containing this user's file is down. If there are many file devices for symbiont/ 

coop only, this user should be aborted. If only one symbiont/coop file device exists, it is pointless to run 
the system with that device down. 



Screech Code - 2D-02 



Called From: 
Message : 
Registers: 



Remarks: 



COOP 

USERS COOP CONTEXT BLOCK CHAIN LOST 

Rl - BUFLIMS index for screech code 19. 

R2 - .BC10. 

SR2 - OPNLD + .137. 

SR4 - OPNLD + .139. 

D3 - 0. 

Similar to 2D-00 but detected at context block open time. Particularly alarming because this check imme- 
diately follows the code which allocates context blocks. 



Screech Code - 2D-03 

Called From: SACT 

Message: 

Register: 



Remarks: 



COOP CONTEXT BLOCK POINTERS CLOBBERED 



R3 - 0. 

R6 - User DCB address. 

SRI - FCN in leftmost 8 bits; DCB address in rightmost 24 bits. 

SR4 - Exit from COOP. 

Either J:USCDX or context block (special pointers) were clobbered. 
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Screech Code - 2D-04 

Called From: SUPCLS 

Message: COOP DATA BUFFERS MISALLOCATED 

Registers: D3 - Buffer being released, including spare buffer index in byte 0. 

R5 - Context block address and DBPOOL which is the address of the free context buffer list. 

R2 - SV:LSIZ. 

SR4 - Return address to caller of RCBUFF. 

Remarks: An attempt was made to release a COOP data buffer when the free data buffer pool was full. Either the free 

data buffer pool has been clobbered or too many buffers have been allocated meaning some other COOP data 
area has been clobbered. 



Screech Code - 2E 

Called From: RDF 

Message: POOL BUFFERS LOST - NONE ALLOCATED CURRENTLY 

Registers: SR3 - DCB address for which buffer is needed. 

D4 - X'2E\ 

Remarks: An attempt was made to get an IPOOL or FPOOL buffer, but none were in the free pool and no open DCB 

had any. Probably either the DCB chain has been clobbered or one or more DCBs have been clobbered. 



Screech Code - 2E-01 

Called From: RA 

Message: INCONSISTENCY IN READ-AHEAD TABLES 

Registers: R12 - Disk address. 

Remarks: An attempt was made to add an AIR block to the tables when it was already there. 



Screech Code - 30 

Called From: PFSR 
Message : 
Registers: 
Remarks: 



UNBALANCED POWER ON/POWER OFF INTERRUPT PAIRS 



Unbalanced power on/power off interrupt pairs, more of one than another (usually power on, or else system 
would hang in wait; i.e., B $-1). 



Screech Code - 31 

Called From: IORT 
Message: INVALID RESOURCE TYPE 

Registers: SR4 - ADDRESS + 1 where discovered. 

Remarks: Invalid resource type found. 
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Screech Code - 32-00 

Called From: IOQ 

Message: DCB DOESN'T CONTAIN A VALID DCT INDEX 

Registers: R2 - Address of DCB. 

Remarks: The DCT index is not present in DCB. 

Screech Code - 34-00 

Called From: TPQ1 

Message: TRANSACTION PROCESSING FAILURE 

Registers: — 

Remarks: The System Queue Manager for transaction processing has discovered an unrecoverable state while processing 

transactions. 



Screech Code - 41-01 

Called From: RTROOT 

Message: FAILED TO FIND USER'S STATE (M:INTSTAT) 

Registers: R2 - Address of ICB being checked. 

Remarks: Probably results from a state having been added to SCHED without updating the four masks used by 

the M:INTSTAT routine (WAIT:MASK, EXU:MASK, IOWAIT:MASK, BLCKD:MASK). 



Screech Code - 41-10 

Called From: RTNR 

Message: BAD IOEX CALL TO NEWQ 

Registers: Set for BALR, 11 NEWQNW. 

Remarks: NEWQNW returned to BAL + 1 . 

Screech Code - 41-11 

Called From: RTNR 

Message: UNABLE TO RETURN PRE-EMPTED DEVICE 

Registers: — 

Remarks: RTNR's call to RMAOV was invalid. 
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Screech Code - 43-01 

Called From: CLOCK4 

Message: NO ICBS CHAINED INTO RTICBCLKHDR 

Registers: — 

Remarks: This is probably caused by overwriting lowcore. 

Screech Code - 43-02 

Called From: CLOCK4 

Message: ICBCLK FIELD OF ICB NEGATIVE 

Registers: R2 - Address of bad ICB. 

RIO - Current timer increment. 

Remarks: The ICBCLK field of an ICB should never go negative. 

Screech Code - 43-03 

Called From: RTNR,CLOCK4 



Message: NO BACK-LINK FOUND IN DE-CHAINED ICB 

Registers: R2 - Current ICB (the one being de-chained) . 

R4 - Forward link (next ICB in chain). 

Remarks: A back-link of zero implies that the current ICB is SYSICB1 (the 1-second CLOCK3 ICB). This ICB should 

never be de-chained (i.e., de-activated). 



Screech Code - 46-21 

Called From: RDF 

Message: PRIVATE VOLUME LOGIC INCONSISTENCY 

Registers: SR4 - Address where error was detected. 

Remarks: Numerous modules call PVERR. 



Screech Code - 49 

Called From: TYPR 

Message: RESOURCE PREALLOCATION INCONSISTENT WITH REQUESTS 

Registers: R2 - 0. 

R3 - Reel number. 
D4 - X'49'. 

Remarks: Due usually to MBS failure to properly set or reset resource flags, resource (tape or private volume) not 

properly or fully released back to system. 
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Screech Code - 56 

Called From: MOCIOP 

Message: UNABLE TO RELEASE PHYSICAL WORK PAGE 

Registers: The registers at the time of the trap. 

Remarks: Originates in the MOCIOP module when unable to release a physical work page locked in core during trans- 

action processing I/O on a message-oriented controller (e.g., 7605). 



Screech Code - 61 - (TRAP Cell) 

Called From: INITRCVR 

Message: TEL OR CCI HAS TRAPPED 

Registers: Registers at time of trap. 

Remarks: 



The trap occurred while operating mapped, slave, and with TEL-in-control set. The subcode is the trap 
location. 



Screech Code - 62 

Called From: SCHED 

Message: USER PROGRAM TOO LARGE FOR PHYSICAL MEMORY 

Registers: R0 - Pages freed. 

R4 - Inswap user (S: IS UN). 

Remarks: R0 > SL:CORE. User got swapped out but now can't fit back in. Pages may be released but not reported. 

The J IT in-core flag =0. (UH:FLG X'200'.) 



Screech Code — 63 

Called From: DPSIO 
Message: 



INSUFFICIENT INFORMATION AVAILABLE TO SWAP THIS USER 



Registers: R2 - IOCD. 

R6 - Command list address. 

R7 - Function code. 

D4 - X'63'. 

Remarks: Insufficient data to compute function, follow-on function code invalid, or flags not set properly. (Disk pack- 

only swappers.) 



Screech Code - 6A 

Called From: MM 

Message: ATTEMPT TO RELEASE VIA M:CVM FROM USER W/O PROPER PRIVILEGE 
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Registers: Rl - X'80'. 

R5 - Address of top of dynamic data or bottom of command. 

R6 - Number of pages to release. 

R7 - Virtual page number. 

SRI - Number of pages released. 

SR2 - First page to release. 

SR3 - Increment or decrement to next page. 

SR4 - Link. 

D1 - CC. 

D2 - CC mask. 

Remarks: Virtual page outside of user's area (BUP-EUP) was obtained by an M:CVM CAL, but the user lacks required 

privilege (X'80 1 ) to release it. 



Screech Code - 6B 

Called From: MM 

Messages: ERROR IN SPARE BUFFER TABLES 

Registers: Rll - Address in buffer subroutine within MM (T:GBUF, T:RBUF, etc.) which detected the error. 

Remarks: Usually due to bad input from the calling routine. 



Screech Code - 6B 

Called From: SWAPPER 

Message: ERROR IN SPARE BUFFER TABLES 

Registers: 



Remarks: 



R6 - BA (window page). 

R14 - Physical page assigned to window. 

Page mapped into window is not contained in the spare buffer pool. 



Screech Code - 79 

Called From:" ENTRY 

Message: MONITOR COMMITTED A STACK TRAP 

Registers: Registers at time of trap. 

Remarks: Master bit on in PSD, overflow, underflow/ or pointer to stack lost. 

Screech Code - 79-01 

Called From: T:OV 
Message: MONITOR STACK TRAP 

Registers: Registers at time of trap. 

Remarks: OSTACK overflow. 
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Screech Code - 7C 

Called From: ALTCP 
Message : 



ALTCP CALLED TO SERVICE A CAL THAT DOESN'T BELONG TO ALTCP 



Registers: R3 - Register field of CAL. 

R6 - First word PLIST. 

R7 - Address of PLIST + 1 . 

SRI - Code. 

SR4 - Exit address (usually TRAPEXIT). 

Remarks: A CAL1, 1 or CAL1, 2 was passed to ALTCP but should have been handled by CALPROC. 



Screech Code -7€- (TRAP Cell) 

Called From: INITRCVR 

Message: MONITOR HAS TRAPPED 

Registers: Registers at time of trap. 

Remarks: Subcode is trap location. For traps that oecur at locations less than X'8000' (JOWPA), the 15 cells pre- 

ceding the trap location and the trap location are stored in the monitor JIT at X'8DFO' — X'8DFF'. 

Screech Code - 87 

Called From: ALLYCAT 

Message: ALLOCATION BUFFERS CONTAIN INVALID WORD COUNT 

Registers: Rl - Stack number. 

R2 - Stack count. 

Remarks: Either low core has been clobbered or someone has changed ALLYCAT's in-core data. 



Screech Code - 88 

Called From: SCHED 

Message: 

Registers: 



Remarks: 



ALLYCAT CLOBBERED ONE OF THE ALLOCATION BUFFERS 



Rl - Stack index. 
R3 - Stack count. 

ALLOCAT end-action has discovered a discrepancy in the granule/cylinder stacks. 



Screech Code - 89-00 

Called From: ALLYCAT 

Message: ALLYCAT'S HGP CHAIN CLOBBERED 

Registers: R7 - Invalid HGP chain address. 

R9 - ALLOCAT internal link register. 

Remarks: ALLOCAT data (HGPs and TABLES) has been destroyed. 
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Screech Code - 93 

Galled From: DPSIO, TSIO 

Message: TDV COMMAND ADDRESS DOESN'T POINT TO COMMAND LIST 

Registers: Rl - 0. 

SRI - Command list address from TDV. 

SR2 - TDV status. 

D2 - Command list pointer (S:BECL,R1). 

Remarks: IOP/memory failure; extraneous entry to TSIO/DPSIO not generated within CLIST. 



Screech Code - 94 

Called From: DPSIO, TSIO 

Message: COMMAND LIST CLOBBERED DURING WRITE CHECK 

Registers: SRI - Incorrect command list entry address. 

SR2 - TDV status. 
R12 - Order code from incorrect command list entry. 

Remarks: Can't find seek or TIC within next five command list entries following error entry on write or write check. 



Screech Code - 95 

Called From: DPSIO, TSIO 

Message: UNRECOVERABLE I/O ERROR READING USER'S JIT 

Registers: Rl - Inswap user number (S:ISUN). 

R7 - DCT index. 

SRI - Command list address from TDV status. 

SR2 - TDV status. 



Screech Code - 96 

Called From: DPSIO, TSIO 

Message: UNRECOVERABLE I/O ERROR READING SHARED PROCESSOR 

Registers: Rl - Inswap user number (S: IS UN). 

R7 - DCT index. 

SRI - Command list address from TDV status. 

SR2 - TDV status. 
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APPENDIX D. XEROX 560 REMOTE ASSIST STATION 



INTRODUCTION 

The Remote Assist Station (RAS) and the associated routines 
comprise the CP-V interface for on-line remote assistance 
for both software and hardware analysts. This facility pro- 
vides an on-line connection to the operating system without 
requiring the use of any of the normal communications 
equipment. The RAS user has access to ELLA for listing and 
analyzing the contents of the system error log file (ERRFILE) 
and to ANLZ and Delta for examining crash dumps and the 
running monitor. 



HARDWARE INTERFACE 

The Remote Assist Station may be any ASCII terminal cap- 
able of connecting to the provided data set (Bell 103 A or 
its equivalent). The data set is connected to the Remote 
Channel Interface of the System Control Processor. (See 
the Xerox 560 Computer Reference Manual, 90 30 76.) 
To use the interface on-line, the REMOTE CHANNEL 
switch on the Xerox 560 System Control Panel must be in 
the I/O position. This connects the remote channel to 
address X'OB 1 on the MIOP in cluster zero, through which 
the CP-V interface communicates. This address must be 
SYSGENed as the Maintenance Control (MC) device. The 
hardware performs character translation from ASCII to 
EBCDIC (and vice versa) to make the terminal appear as 
an EBCDIC device. The translation tables are depicted in 
Table D-l. The left side of the table shows standard ASCII 
characters. The corresponding entries in the right side of 
the table show EBCDIC translation. 



— OM9T=I © (required for mounting tape dumps) 

._© 

-END® 

LOGON verifies the OMMC authorization before it ac- 
cepts the account and name, and will not allow the user to 
log on if he does not have this resource authorization. 

If the user's account and name are accepted, the user is 
logged on as a non-COC on-line user and LOGON exits to 
TEL which issues a prompt for input (!). 



PROCESSOR RESTRICTIONS 

The MC authorization causes a :PROCS entry to be created 
for the RAS user which restricts him to the following list 
of processors: 

ANLZ 

Delta 

ELLA 

No other processors or programs are allowed at the RAS. 
Except for these processor restrictions, TEL will accept most 
of its commands (e.g., SET, PRINT, MESSAGE, QUIT, 
GO). However, commands regarding terminal type and 
status will be ignored. 



SOFTWARE INTERFACE 

CP-V provides an on-line communications interface enab- 
ling the remote analyst to log onto the Maintenance Console 
much as if he were connected to a COC terminal line. The 
interface is initiated at the Operator's Console (OC) by a 
special form of the GJOB key-in after the RAS is connected 
to the dial-up modem: 

1GJOB LOGON, MC 

This key-in causes LOGON to print a salutation to the MC 
resource requesting the RAS user to enter his account and 
name. The RAS user must be explicitly authorized via Super 
to use the MC resource. The following is an example of 
such a Super authorization: 

-C RAS, ASSISTANCE © 

— O$PR=A0 © (required for running diagnostic 
programs) 

— OMMC=l© (authorizes on-line use of the MC 
resource) 



COMMUNICATIONS RESTRICTIONS 

The communications link to RAS uses a small resident 
handler in conjunction with the hardwired micro-coded 
controller to provide a terminal interface. Due to the 
limitations of the hardware and size restrictions on the 
software handler, some compromises have been made. The 
following list outlines the major characteristics of the com- 
munications interface: 

1. The MC device is a message mode device, requiring 
either LINE FEED, RETURN, CONTROL X, or CON- 
TROL H to end each input. LINE FEED and RETURN 
generate an X'15' (NL) character. CONTROL X and 
CONTROL H generate an X'08' (EOM) character which 
is used to cancel an input line so that the line may be 
retyped. 



Although the RAS terminal is connected in full-duplex, 
the MC device operates in half-duplex, echoplex 
mode, allowing I/O transfer a line at a time in only 
one direction. When a read is pending, characters 
typed will be echoed to the print mechanism of the 
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Table D-l. ASCII to EBCDIC Translate Table 



ASCII 


EBCDIC 







1 


2 


3 


4 


5 


6 


7 







1 


2 


3 


4 


5 


6 


7 





NUL 


DLE 


SP 





@ 


P 


\ 


P 





NUL./ 


DLE / 
/ ,0 


SP // 
// 40 


// 
// F0 


© 


P // 
//D7 


//4A 


P // 
// D7 


1 


SOH 


DC1 


i 


I 


A 


Q 


a 


q 


1 


SOH// 
// 01 


DC1 / 
// 11 


1 ./ 
// 5A 


1 // 
// Fl 


A // 
// CI 


Q // 
//D8 


a®/ 

//CI 


Q // 
// DB 


2 


STX 


DC2 


- 


2 


B 


R 


b 


r 


2 


STX// 
/ 02 


DC2// 
// 12 


ii // 

// 7F 


2 // 
// F2 


B // 
// C2 


R // 
// D9 


B // 
// C2 


R // 
// D9 


3 


ETX 


DC3 


# 


3 


C 


S 


c 


s 


3 


ETX// 
/ 03 


DC3 // 
// 13 


# // 
// 7B 


3 // 
// F3 


C // 
// C3 


S // 
//E2 


C // 
// C3 


S // 
// E2 


4 


EOT 


DC4 


$ 


4 


D 


T 


d 


t 


4 


EOT// 
/ 04 


DC4 / 
// 14 


$ y/ 

// 5B 


4 // 
// F4 


D // 
// C4 


T // 
// E3 


D // 
// C4 


T // 

// E3 


5 


ENQ 


NAK 


% 


5 


E 


U 


e 


V 


5 


ENQ// 
// 09 


NAK// 
/0A 


% // 
// 6C 


5 // 
// F5 


E /^ 
// C5 


U// 
// E4 


E// 
// C5 


U // 
// E4 


6 


ACK 


SYN 


& 


6 


F 


V 


f 


V 


6 


© 


SYN// 
// 16 


& // 
// 50 


6 // 
// F6 


F // 
// C6 


V// 
// E5 


F // 
// C6 


V // 
//E5 


7 


BEL 


ETB 


/ 


7 


G 


W 


g 


w 


7 


BEL// 
// 07 


ETB // 
// 17 


// 7D 


7 // 
// F7 


G// 
// C7 


W // 
// E6 


G// 
// C7 


W // 
// E6 


8 


BS 


CAN 


( 


8 


H 


X 


h 


X 


8 


© 


© 


( // 
>/ 4D 


8 // 
// F8 


H// 
// C8 


X// 
// E7 


H// 
// C8 


X // 
// E7 


9 


HT 


EM 


) 


9 


I 


Y 


i 


y 


9 


HT // 
/ 05 


EM // 
// 19 


) >/ 
// 5D 


9 // 
// F9 


I // 
// C9 


Y// 
// E8 


I // 
// C9 


Y // 
// E8 


A 


LF 
NL 


SUB 


* 




J 


Z 


i 


z 


A 


NL // 
// 15 


SUBy/ 
// 1A 


// 5C 


// 7A 


J // 
// Dl 


Z // 
// E9 


J// 
//Dl 


Z // 
// E9 


B 


VT 


ESC 


+ 


; 


K 


[ 


k 


{ 


B 


VT / 
//0B 


ESC // 
// LB 


+ // 
// 4E 


// 5E 


K // 
// D2 


1 // 
// 4F 


K// 

// D2 


// B2 


C 


FF 


FS 


' 


< 


L 


\ 


i 


1 


C 


FF / 
// OC 


FS // 
// 1C 


> // 

// 6B 


< // 
// 4C 


L // 
// D3 


// 4A 


L // 

// D3 


1 // 
// 4F 


D 


CR 


GS 


- 


= 


M 


] 


m 


} 


D 


NL / 
// 15 


GS // 
// ID 


// 6D 


// 7E 


M// 
// D4 


- 1 // 
// 5F 


M// 
// D4 


// B3 


E 


SO 


RS 




> 


N 


s\ 


n 


~ 


E 


SO / 


RS // 
// IE 


// 4B 


> // 
// 6E 


N// 

// D5 


/V ' >/ 

// 6A 


N// 

// D5 


// 5F 


F 


SI 


US 


/ 


? 


O 


- 


o 


DLE 


F 


SI / 
//OF 


US // 
//IF 


/ >/ 

// 61 


? // 
// 6F 


O// 
// D6 


//6D 


° / 
/ D6 


/ // 
// 4A 


Notes: CO Used by Diablo Centaur terminal EOT/ACK protocol. 

\2) Used to cancel line, echoes as - — ©© and reissues read unless Delta is in control in which case is input as OA (LF). 

(V) Causes previously typed character to be ignored (Rubout character). 

(4 J Lower case input is echoed lower case, but translated to upper case for program input. 



166 Appendix D 



terminal. If a read is not pending, characters typed 
are not echoed and are ignored. 

The BREAK key may be depressed at any time to in- 
dicate a BREAK signal. The MC handler causes a 
BREAK event to be issued for the user and counts suc- 
cessive BREAKs. If the user issues four successive 
BREAKs, the handler causes a CONTROL Y event 
(i.e., an escape to TEL). The BREAK key cancels any 
current I/O operation to the terminal. 

In order to detect line drop or disconnect, input re- 
quests will time out in three minutes and output mes- 
sages will time out in 20 seconds. A failure to respond 
to a read within three minutes causes the RAS user to 
be logged off. 

Records output to the RAS terminal have a maximum 
size restriction of 140 bytes. Trailing blanks in an 
output record are suppressed by the MC handler. Rec- 
ords output through DCBs other than M:UC have a 
RETURN/LINE FEED appended to them. Records writ- 
ten through M:UC must contain their own carriage 
control characters. 

The MC handler does not simulate tabs nor does it 
affect pagination. 



7. Individual characters may be erased on input by typing 
@ characters for each character to be erased (e. g. , 
'ANE@LZ' results in 'ANLZ'). Complete lines may 
be erased by ending the line with CONTROL X or 
CONTROL H which causes the handler to echo 

© © 
and to reissue the read that was in operation. 

8. End-of-file condition is set upon receipt of the three 
character sequence CONTROL F®. 

9. Lower case letters are echoed in lower case but are in- 
put to the program as upper case. 

10. When Delta issues a read, special action takes 
place by the handler to simulate the Delta activa- 
tion character set. Special Activation characters 
(CONTROL I , ) = /) should be immediately fol- 
lowed by a RETURN or LINE FEED. For commands 
which usually end with a RETURN, either a RETURN 
or a LINE FEED is valid. Commands which normally 
end in LINE FEED should be ended with CONTROL X 
or CONTROL H. Line erasure is effected by ending 
the line of input with ? RETURN. 
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APPENDIX E. ERRFILE FORMATS 



ERRFILE is a keyed file built and updated by ERR:FIL for 
use by diagnostic programs. The file contains one record 
for each error entry in the file created by ERRLOG. 

The keys for this file contain the Julian date in packed 
decimal/ the time of the error in EBCDIC, and a sequence 
number for errors with the same time tag. This sequence 
number is reset to zero for each entry with a new time tag. 
The format of the key is 



yyOddd is the Julian date in packed decimal, 

hhmm is the time (hours and minutes) in EBCDIC, 
n is the sequence number. 



The first record of ERRFILE is the key of the last record in 
ERRFILE and has a key of zero. 



08 


YY 


Od 


dd 


h 


h 


m 


m 


n 









where 

08 is the number of bytes in the key. 



While copying records into ERRFILE, consistency and error 
checks are made on the input data. If any errors or in- 
consistencies are found, "copy error" records are written 
and a "copy error" counter in the summary record is in- 
cremented. The error and consistency checks, recovery 
actions taken, and the format of the copy error records are 
described below. The terminology used in the error record 
formats is defined in Table E-l. 



Table E-l. Error Record Terminology 



Term 


Meaning 


Account 


The doubleword used to identify a user's collection of files. 


AIOCC 


A 4-bit field representing the condition codes as returned by the hardware 
in response to an AIO instruction. 


AIO Status 


A 16-bit field representing the status as returned by the hardware in response 
to an AIO instruction. 


Alternate I/O Address 


A 16-bit value representing an alternate physical I/O address by which a 
dual -access device can be referenced. 


Bytes Remaining 


A 16-bit field representing the Remaining Byte Count (RBC) field as returned 
by the hardware in response to a TDV instruction. 


Consecutive, Keyed, Random 


Methods of organizing user files in CP-V (refer to the CP-V/BP Reference 
Manual, 90 17 64). 


Count of Entries Identical to 
Previous Entry 


The number of error log records which are identical to one previously logged 
for identical reasons (excludes time records). 


Count of Entries Lost 


The number of error log records lost when logging becomes temporarily im- 




possible for any reason. 


Current Command Doubleword 


A 64-bit value representing the command doubleword currently being pro- 
cessed for a device (indicated by the TDV status DW). 


Caller's Address 


The address back to which the error logging routine is returned when logging 
is complete; used in isolating software faults. 


DCT Index 


The 8-bit value indicating the order in which the device is configured into 
the system (at SYSGEN). 


DCT Index of Symbiont Device 


The 8-bit value indicating the order in which the device associated with the 
symbiont is configured into the system (at SYSGEN). 
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Table E-l. Error Record Terminology (cont. ) 



Term 



Meaning 



Effective Address 
Error Subcode 

File Name 
Granule 
HIO CC 

HIO Status 

I/O Address 
I/O Count 

Julian Day 

Length 



Memory Status Words 
(Sigma 9 only) 

MFI (Sigma 6 or 7 only) 



Mode 

Model Number 

Number of Parity Errors 

Primary I/O Address 

PSD 

Real Address 

Recovery Count 

Relative Sector Address 

Relative Time 



A 32-bit value representing the final address computed for the instruction 
pointed to by the instruction address (IA) in the PSD. 

An 8-bit field indicating which of several types of file inconsistencies has 
occurred (see CP-V/BP Reference Manual, 90 17 64). 

The TEXTC name used to identify a collection of user data on secondary storage. 

The unit of secondary storage allocation equal to 2048 bytes (usually 2 sectors). 

A 4-bit value (bits 0-3 of designated byte) representing the condition codes 
as returned by the hardware in response to an HIO instruction. 

A 16-bit value representing the status as returned by the hardware in response 
to an HIO instruction. 

A 16-bit value representing the physical I/O address. 

A 32-bit value representing the number of SIO instructions executed for the 
device. 

A 16-bit value representing the Julian day of the year (e.g., March 1 would 
be represented as X'3D') when the error was logged. 

A 8-bit value in the second byte of the error log record representing the 
number of useful 32-bit words contained in the error log record. It includes 
the first word in the count. 

Each word is a 32-bit value representing data returned by the hardware in 
response to an LMS instruction. 

A 4-bit value representing the current state of the memory fault indicators 
returned by the hardware in response to an RD instruction. All memory fault 
indicators will be reset. 

A 16-bit value representing the manner in which the file was last referenced 
(see CP-V/BP Reference Manual, 90 17 64). 

A 16-bit value representing the model number assigned by Field Engineering to 
uniquely identify peripheral devices (e.g., 7242would be represented as X'7242'). 

A 16-bit value representing the number of bad locations causing memory 
parity errors (only the first 14 bad locations are entered in the log if the num- 
ber of errors is greater than 14). 

A 16-bit value representing the physical I/O address by which a device can 
be referenced (see Alternate I/O Address). 

A 64-bit value representing the program status doubleword. 

A 32-bit value representing the actual memory address (in a mapped system, 
this is the same as the address in the IA field of the PSD). 

An 8-bit value initialized to zero at system initialization and incremented by 
the value one for every system recovery. 

A sector is 256 words. Each sector on a given device is numbered zero through 
device end. CP-V maintains file pointers by relative sector number, thereby 
simplifying the logic necessary to address different devices. 

A 32-bitvalue representing milliseconds since midnight. Resolution is 2 msec. 
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Table E-l. Error Record Terminology (cont.) 



Term 


Meaning 


Relative Time Resolution 


An 8-bit value, n, such that actual relative time resolution =2 msec, (e.g., 
n = 1 for a resolution of 500HZ or 2 msec). 


Retries Remaining 


An 8-bit value representing Retry Request minus the number of entries at- 
tempted. The range is between Retry Request and -1 . A value of -1 indicates 
the operation was terminated due to retry count rundown. 


Retry Request 


An 8-bit value representing the maximum number of retries after which a device 
error is returned to the requester. This value is obtained from the requester's 
DCB. 


Screech Code 


The code used by CP-V to identify the system failure which has occurred. 


Screech Subcode 


An 8-bit field identifying which type of a specific and similar set of system 
failures has occurred. (See Software check codes in the CP-V/OPS Reference 
Manual, 90 16 75.) 


Seek Address 


The physical disk address last used to access this device. 


Sense Information 


The diagnostic information returned from the device as a result of sending a 
"sense" order to the device. 


SIO CC 


A 4-bit value (bits - 3 of designated byte) representing the condition codes 
as returned by the hardware in response to an SIO instruction. 


SIO Status 


A 16-bit value representing the status as returned by the hardware in response 
to an SIO instruction. 


Site Identification 


A 64-bit field containing the site ID from the SYSGEN :MON card left 
justified with blanks on the right. 


Startup Type 


An 8-bit field indicating which of several types of system initialization was 
used. See the SYSTEM STARTUP error record ( type X'18'). 


Subchannel Status 


The status of the I/O subchannel received from the hardware as a result of a 
TDV instruction. 


Symbiont File 


A CP-V system special file for buffering data between the CPU and slower 
speed line printers, card punchers, etc. 


TDVCC 


A 4-bit value (bits - 3 of designated byte) representing the condition codes 
as returned by the hardware in response to a TIO instruction. 


TDV Current Command DA 


A 24-bit field representing the current command doubieword address used in 
obtaining the device status with a TDV instruction. 


TDV Status Doubieword 


A 24-bit field representing the subchannel status, as current command double- 
word, device status, and byte count as returned by the hardware in response to 
a TDV instruction. 


TIOCC 


A 4-bit value (bits - 3 of designated byte) representing the condition codes 
as returned by the hardware in response to a TIO instruction. 


TIO Status 


A 16-bit value representing the status as returned by the hardware in response 
to a TIO instruction. 


Trap CC 


A 4-bit value (bits - 3 of designated byte) representing the condition codes 
as returned by the hardware when certain traps occur. 
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Table E-l. Error Record Terminology (conr. 



Term 


Meaning 


Trapped Instruction 


A 32-bit value representing the contents of the location pointed to by the 
instruction address (IA) in the PSD. 


Type 


An 8-bit value in the first byte of the error record which identifies the type 
of record. 


Unit Address 


A 6-bit value (bits 2 - 7 of designated byte) representing the address by which 
a processor can be referenced; the value is composed of a 3-bit cluster number 
followed by a 3-bit unit number. 


Unit Type 


An 8-bit value specifying the type of processor. Bit of the designated byte 
indicates the presence of the processor in the current operational configuration 
(0 = present, 1 = not present) . 


User ID 


A 16-bit value which is a unique number assigned by the system to the partic- 




ular job or on-line session. 


User Number 


An 8-bit value which is the index into internal system tables used to access 
user specific information. 


Version 


The version identifier of the system running (i.e., A00, BOO, etc.). This field 
is one byte in length. The letter of the version is stored in the first four bits 
and the number of the version is stored in the second four bits. 


Volume Serial Number 


A 4- or 6-byte field supplied by a user to identify either a tape or private 
pack . 


Year 


A 16-bit binary value representing the current year minus 1900 (e.g., 1973 is 
represented as X'49'). 



READ ERROR 

If the condition codes set by TrRDERLOG indicate a read 
error, a copy error record (Read Error) is written and copy- 
ing of the record is attempted. If inconsistencies are found 
in the record, a copy of the bad record is placed in the 
ERRFILE file, followed by the End Read Error record. If no 
inconsistencies are found, the record is processed normally 
and the Read Error record remains in the ERRFILE file. The 
record formats are 



End Read Error 
word 



Type 
X'10' 



Length 
X'02' 



1 2 3 14 5 6 7 8 9 10 111 12 13 H 15116 17 18 19120 21 22 23724 25 26 27128 29 30 3 



Subtype 
X'Q2' 



word 1 



Relative time 



1 2 3 I 4 5 6 7 18 9 10 11 F 12 13 14 151 16 17 18 19120 21 22 23124 25 26 27128 29 30 31 



Read Error 
word 



Type 
X'10' 



Length 
X'02' 



1 2 3 14 5 6 7 18 9 10 111 12 13 14 15 16 17 18 19l 20 21 22 23 24 25 26 27128 29 30 31 



Subtype 
X'OT 



word 1 



Relative time 



1 2 3U 5 6 7 Is 9 10 111 12 13 14 15l 16 17 18 I9I2O 21 22 23 1 24 25 26 27 1 28 29 30 31 



ERRLOG RECORD LENGTH ERROR 

If the length of the ERRLOG record is greater than 64 words, a j 
copy error record followed by the ERRLOG record is written 
on ERRFILE. No attempt is made to copy this record in the 
detailed format. The record format is 

word 



Type 
X'10' 

1 2 3 U 5 6 7 



Length 
X'03 1 

9 10 111 12 13 14 15 



16 17 18 19120 21 22 23 



Subtype 
X'Q3 ' 

24 25 26 27 1 



25 26 27i 28 29 30 31 
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word 1 



Relative time 

TT~1 5 3T4 5 6 7T8 9 10 llll2 13 14 15 1 16 17 18 1* 1 26 2l H 23^4 J5 26 27 1 iB 29 30 1 



word 2 



Index to bad entry 

1 2 3 I 4 5 6 7 18 9 10 111 12 13 14 I5I16 17 18 19 1 20 21 22 23 1 24 25 26 27 1 28 29 30 31 



INCORRECT TIME 

If the time of an entry is out of sequence, i.e., if it is 
earlier than the time of the last record and the data has not 
changed, a copy error record is written on ERRFILE followed 
by the ERRLOG record. The time of this entry is then used 
for the key and processing continues. The record format is 

word 



Type 
X'10' 



Length 
X'03' 



12 314 5 6 7 18 9 10 11112 13 14 15116 17 18 19120 21 22 23124 25 26 27128 29 30 31 



#5? 



word I 



Relative time 



1 2 3T4 5 6 7 18 9 10 111 12 13 14 15 1 16 17 18 I9I 20 21 22 23 ! 24 25 26 27 1 28 29 30 31 



word 2 



Index to bad entry 



~\ 2 3 I 4 5 6 7 I 8 9 10 111 12 13 14 15l 16 17 18 19 ! 20 21 22 23 ! 24 25 26 27)28 29 30 31 

where index is the displacement within the ERRLOG record 
of the first word of erroneous entry. 



ILLEGAL ENTRY TYPE 

If the entry type is not one of the legal types, a copy error 
record followed by the ERRLOG record is written on ERRFILE. 
No attempt is made to copy the remainder of the record. 
The record format is 



Note: Errors that occur while booting have a time tag of 
24XX but the keys of these records contain the cur- 
rent date and 0011 for the time. 

If read or write errors are detected while reading or writing 
ERRFILE and SUMFILE, they are ignored. 

Whenever I/O errors or certain unusual conditions occur, 
an entry will be made into the ERRLOG file. This entry 
will contain any information pertinent to the condition. 

Word of each entry will have a code indicating which 
error or unusual condition is present along with the number 
of words in the entry (including word 0). Time (hhmm) and 
Device Name (yyndd) are in EBCDIC. 

There are no error log entries for the following two interrupts. 



MEMORY FAULT INTERRUPT 

The Memory Fault Interrupt (MFI) is triggered when an error 
is detected during a memory access by either the CPU or an 
IOP. If the MFI is triggered by the CPU, a parity error trap 
will also occur unless the error is a Loop Check Parity error 
or Overtemperature condition. The parity error trap routine 
performs error recovery, logs the error, and clears the MFI 
to avoid duplicate processing. The MFI service routine 
therefore expects to only handle errors detected during an 
IOP memory access and Loop Check and Overtemperature 
errors. The Loop Check and Overtemperature errors are 
processed by the memory parity program and the system re- 
covery program is entered with code X'23'. The other er- 
rors are logged by the device handler, which also performs 
the required recovery. 



PROCESSOR FAULT INTERRUPT 

The Processor Fault Interrupt is not enabled in CP-V. Errors 
that cause this interrupt in a monoprocessor system are han- 
dled by the I/O Interrupt Routines. 



SIO FAILURE 

This record is logged when CC1 and/or CC2 are set after 
execution of the SIO instruction. 



word 



Type 
X'10' 



Length 
X'03' 



1231456789 10 llll2 13 14 15 16 17 18 19120 21 22 23 24 25 26 27128 29 30 31 



Subtype 
X'( 



27128 



word 1 



Relative time 

i 2 3 I 4 5 6 7ls 9 10 111 12 13 14 15 1 16 17 18 19l 20 21 22 23 1 24 25 26 27 1 28 29 30 31 



word 2 



Index to bad entry 

i 2 Ft! T~i 7 I 8 9 10 111 12 13 14 15 1 16 17 18 19 1 20 21 22 23 1 24 25 26 27 1 28 29 30 3 



where index is the displacement within the ERRLOG record 
of the first word of erroneous entry. 



word 



Type 
X'll* 


Length 
X'06' 


Model number 


1 2 3 U 5 6 7 


8 9 10 111 12 13 14 15 


16 17 18 I9I2O 21 22 23l 24 25 26 27 1 28 29 30 31 



word 1 



Relative time 



32 33 34 35l36 37 38 39l40 41 42 43 1 44 45 46 47I48 49 50 51 1 52 53 54 55I56 57 58 5?l60 61 62 63 



word 2 



SIO status 



1 2 3 14 5 6 7 18 9 10 11M2 13 14 15 



I/O address 



16 17 18 19120 21 22 23124 25 26 27128 29 30 31 



172 Appendix E 



word 3 

MF1 (if 
Sigma 6 or 7) 



SIOCC 



TDVCC 



i 2 3 14 5 6 7 18 9 10 111 12 13 14 151 16 17 18 19|20 21 22 23124 25 26 27128 29 30 31 



word 4 



Subchannel 
status 



1 2 31 4 5 6 7 

word 5 



TDV current command DA 



8 9 10 111 12 13 14 15116 17 18 19120 21 22 23124 25 26 27128 29 30 31 



TDV status 

i 2 3 I 4 5 6 7 I 8 9 10 111 12 13 14 15 



Bytes remaining 



16 17 18 19120 21 22 23124 25 26 27128 29 30 31 



TIME OUT 

This record is logged when the I/O interrupt does not occur 
within a specified time period in response to an I/O 
instruction. 

word 



Type 
X'12' 



Length 
X'OD' 



Model number 



1 2314567189 10 111 12 13 14 15 16 17 18 19T20 21 22 23124 25 26 27128 29 30 31 



1 20 21 22 23I2 



word 1 



Relative time 



0~T 23l4567l89 10 ljj 12 13 14 15I16 17 18 19I20 21 22 23 1 24 25 26 27I28 29 30 31 



word 2 






HIO status 

0123U567I891011 


12 13 14 15 


I/O address 

16 17 18 19l20 21 22 23l24 25 26 27 1 28 29 30 31 



word 3 








MFI (if 
Sigma 6 or 7) 


HIO CC 


TDV CC 


TIOCC 


1 2 3 U 5 6 7 


8 9 10 111 12 13 14 15 


16 17 18 19l20 21 22 23 


24 25 26 27I28 29 30 31 



word 4 



Subchannel 
status 



TDV current command DA 



1 2 314 5 6 7 18 9 10 11112 13 14 15116 17 18 19120 21 22 23124 25 26 27128 29 30 31 



word 9 



I/O count for this device 



1 2 3 14 5 6 7 18 9 10 11 1 12 13 14 151 16 17 18 19120 21 22 23124 25 26 27128 29 30 31 



words 1 and 1 1 



Volume serial number 



(Six characters for 
ANS tapes) 

' : : -Is- •- • 



Original 
function code 



1 2 314 5 6 718^9 10 11M2 13 14 151 16 17 18 191 20 21 22 23 24 25 26 27128 29 30 31 



Current 
funct ion c ode 

27T2 



word 12 










































Seek address 


1 2 3 U 


5 


6 




8 


9 


10 


11 


12 13 14 151 16 17 18 19 


20 


21 


22 


23 


24 


25 


26 


27 


28 


29 


30 


31 



UNEXPECTED INTERRUPT 

This record is logged when an interrupt, other than an at- 
tention interrupt, is received from a known device for 
which no I/O operations have been started by the system. 

word 



Type 
X'13 1 



12 3 14 5 6 7 



Length 
X'04' 



9 10 111 12 13 14 15 



Model number 



16 17 18 19120 21 22 23124 25 26 27128 29 30 31 



word 1 



Relative time 



1 2 3 I 4 5 6 7l 8 9 10 111 12 13 14 15 1 16 17 18 19l 20 21 22 23124 25 26 27128 29 30 31 



word 2 



AIO status 



1 2 3 14 5 6 7l8 9 10 111 12 13 14 15116 17 18 19 1 20 21 22 23l24 25 26 27128 29 30 31 



I/O address 



I 20 21 22 23 1 2 



word 3 



rTTWF : T : F : ? 



AIOCC 



9 10 111 12 13 14 15 



17 18 19120 21 22 23124 25 26 27T 28 29 30 3: 



word 5 






TDV status 


Bytes remaining 


12 3 


4 5 6 7 18 9 10 111 12 13 14 15 


16 17 18 19120 21 22 23l 24 25 26 27 1 28 29 30 31 



words 6 and 7 



Current command 



doubleword 



1 2 314 5 6 718 9 10 11112 13 14 15116 17 18 19120 21 22 23124 25 26 27128 29 30 31 



word 8 



TIO status 



Retry 
reauest 



Retries 
remainina 



i 2 3 14 5 6 7 i 8 9 10 11 1 12 13 14 15 1 16 17 18 l?l 20 21 22 23 1 24 25 26 27 1 28 29 30 31 



DEVICE ERROR 

This record is logged when general analysis of the status re- 
ceived from an AIO, TDV, or TIO indicates an error which 
resulted from the I/O operation. 



word 



Type 
X'15- 



Length 
X'OD' 



Model number 



1 2 3 14 5 6 7 8 9 10 11112 13 14 151 16 17 18 19120 21 22 231 24 25 26 27128 29 30 31 



word 1 



Relative time 

i 2 3 I 4 5 6 7 I 8 9 10 11 1 12 13 14 15 1 16 17 18 19 1 20 21 22 23 1 24 25 26 27I 28 29 30 31 
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word 2 



word 



AIO status 



I/O address 



1 2 314 5 6 7 18 9 10 11112 13 14 15 [ 16 17 18 19120 21 22 23124 25 26 27 1 28 29 30 31 

word 3 



MFI (if 
Sigma 6 or 7) 



AIOCC 



TDVCC 



TIOCC 



i 2 3 14 5 6 7 IB 9 10 11 1 12 13 14 15 ( 16 17 18 1*1 20 21 22 23 1 24 25 26 27 1 2B 29 30 31 

word 4 



Subchannel 
status 



TDV current command DA 



i 2 3 14 5 6 7 18 9 10 111 12 13 14 15 1 16 17 18 19l 20 21 22 23 1 24 25 26 27 1 28 29 30 31 



word 5 



TDV status 



Bytes remaining 



i 2 3 I 4 5 6 7ts 9 10 111 12 13 14 15 1 16 17 18 19 ! 20 21 22 23! 24 25 26 27 1 28 29 30 31 



words 6 and 7 



Current command 
doubleword 



^tl 5 6 7~tl 9~ 



10 11112 13 14 15116 17 18 19120 21 22 23124 25 26 27 1 28 29 30 31 



word 8 



TIO status 



Retry 
request 



Retries 
remaining 



i 2 3 I 4 5 6 7 I 8 9 10 llll2 13 14 15 1 16 17 18 19 1 20 21 22 23W4 25 26 27 1 28 29 30 31 



word 9 



I/O count for this device 



I 2 3 I 4 5 6 7~l"8 9 10 111 12 13 14 isl 16 17 18 I9I2O 21 22 23I 24 25 26 27! 28 29 30 31 



words 10 and 1 1 



Volume serial number 



(Six characters for 

ANS tapes ' ) 

I 4 5 6 7 I 8 9 10 111 12 13 14 15 



Original 
function code 



16 17 18 19120 21 22 23 



Current 
function code 



24 25 26 27128 29 30 31 



Type 
X'16' 



Length 
(variable) 



I/O address 



i 2 3 1 4 5 6 7 I 8 9 10 11 1 12 13 14 15H6 17 18 19l 20 21 22 23 1 24 25 26 27 1 28 29 30 31 



word 1 



Relative time 



1 2 314 5 6 718 9 10 11112 13 14 15116 17 18 19120 21 22 23 1 24 25 26 27128 29 30 31 



words 2 and following 



Sense information (left justified) 

Device Length (in bytes) 

7242 10 

Disk A, B 16 

1600 bpi tape 6 

9T tape 1 

RAD 3 



i 2 3 I 4 5 6 Tfl 9 10 111 12 13 14 15 1 16 17 18 19 1 20 21 22 23 1 24 25 26 27 1 28 29 30 31 

The L^O address links the secondary record to the cor- 
responding device error entry. 

HARDWARE ERROR 

This record is logged when a hardware error has been de- 
tected, the type of error being indicated by the Trap CC. 
For Sigma 6 and 7, this record is generated as a result of 
the memory parity interrupt associated with location X'56'. 
For Sigma 9 and Xerox 560 this record is generated as a re- 
sult of the parity error trap associated with location X'4C'. 

word 



Type 
X'17' 



Length 
X'OA' 



Trap CC 



i 2 Tt* 5 6 718 9 10 111 12 13 14 15M6 17 18 19I 20 21 22 23 1 24 25 26 27 1 28 29 30 3 



word 1 



Relative time 



1 2 3 14 5 6 7 18 9 10 11112 13 14 15116 17 18 19120 21 22 23124 25 26 27126 29 30 31 



word 12 



Seek address 



1 2 3 I 4 5 6 Tta 9 10 111 12 13 14 15 1 16 17 18 19 1 20 21 22 23! 24 25 26 27 i 28 29 30 3 



words 2 


' and , 


3 




















































PSD word 1 
PSD word 2 












































12 3 


U 5 6 


7 


8 


9 


10 


11 


12 13 14 15 1 16 17 18 


19 


20 


21 


22 


23 


24 


25 


26 


27 


28 


29 


30 


31 



SECONDARY RECORD FOR DISK PACK, RAD, AND 
TAPE 

This record is generated as a result of a previous device 
error and contains device status which corresponds to the 
information contained in the Device Error record (type 
X'15') preceding this record. 



words 4 and 5 




1 2 3 I 4 5 6 7 18 9 10 1 1 I 12 13 14 15 1 16 17 18 19[ 20 21 2223124 25 26 27 1 28 29 30 31 
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word 6 



Real address of trapped instruction 



1 2 3T4 5 6 718 9 10 11112 13 14 15116 17 18 19120 21 22 23124 25 26 27128 29 30 31 



word 



Type 
X { 18' 



i 2 3 14 5 6 7 



Length 
X'04' 



9 10 111 12 13 14 15 



Startup 
type 



16 17 18 19120 21 22 23 



Recovery 
count 



24 25 26 27T28 29 30 31 



word 7 



Trapped instruction 



i 2 3 I 4 5 6 7 I 8 9 10 1 1 1 12 13 14 I5I16 17 18 I9I2O 21 22 23 1 24 25 26 27! 28 29 30 31 



word 1 



Relative time 



1 2 3 I 4 5 6 7 I 8 9 10 111 12 13 14 15 1 16 17 18 19 1 20 21 22 23 1 24 25 26 27 1 28 29 30 31 



word 8 



ANLZ CC 



Effective virtual address 



1 2 3 U 5 6 7 8 9 10 11 1 12 13 14 15 1 16 17 18 19120 21 22 23124 25 26 27128 29 30 31 



word 2 



Year (last two digits; 
in binary) 



Julian day (in binary) 



1 2 3T4 5 6 718 9 10 111 12 13 14 151 16 17 18 19120 21 22 23l24 25 26 27T28 29 30 31 



word 9 






















































Effect! 


ve 


real 


address 




















12 3 


4 


5 


6 


7 


8 


9 


10 111 12 13 


14 


15ll6 17 


18 19l20 21 22 


23 


24 


25 


26 


27 


28 


29 


30 


31 



word 3 






Screech code 


Screech 
subcode 




1 2 3 U 5 6 7 


8 9 10 111 12 13 14 15 


16 17 18 19120 21 22 23124 25 26 27128 29 X 31 



where 



FIP indicates, when set, that a parity error occurred 
while fetching the instruction (causing a trap 4C) 
on a Sigma 9 or Xerox 560, or that a memory par- 
ity occurred (causing a machine interrupt using 
location 56) on a Sigma 6 or 7. 

IAP indicates, when set, that a parity error oc- 
curred due to an indirect address fetch. Words 8 
and 9 will be zero in this case. 

RBP indicates, when set, that a parity error is 
present in the associated R-block registers. 
(Xerox 560 only.) 

ANLZ CC specify the addressing type for the 

effective real address (words 8 and 9). If 
the instruction is an immediate type, these 
address fields will be zero. The ANLZ CC 
settings are: 

Bit Bit 1 Bit 2 Bit 3 









- 





Byte 








- 


1 


Immediate, byte 





1 


- 





Halfword 


1 





- 





Word 


1 





- 


1 


Immediate, word 


1 


1 


- 





Doubleword 


- 


- 





- 


Direct addressing 


- 


- 


1 


- 


Indirect addressing 



where 

screech code and screech subcode are defined in 
the CP-V/OPS Reference Manual, 90 16 75. 

recovery count is set to for initial startup as de- 
fined by startup types 1, 2, or 3 below. 

startup type specifies the type of startup. 

1 - Initial PO boot 

2 - PO boot with files 

3 - System device boot (no recovery) 

4 - System recovery 

5 - Operator recovery 

WATCHDOG TIMER 

This record is generated as a result of the instruction watch- 
dog timer runout trap associated with location X'46'. 

word 



Type 
X'19' 



Length 
X'09' 



1 2 3 14 5 6 7 18 9 10 11112 13 14.15116 17 18 19120 21 22 23124 25 26 27128 29 30 31 



Trap CC 



word 1 



Relative time 



1 2 3 14 5 6 7 18 9 10 11 1 12 13 14 151 16 17 18 191 20 21 22 23124 25 26 27128 29 30 31 



SYSTEM STARTUP 

This error is legged at system initialization and at svery 
recovery. 



words 2 and 3 




PSD word 1 




PSD word 2 



i 2 3 1 4 5 6 7 I 8 9 10 llll2 13 14 I5I16 17 18 I9I 20 21 22 23! 24 25 26 27 1 28 29 30 31 
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words 4 and 5 




1 2 3 14 5 6 7 18 9 10 11112 13 14 15116 17 18 19120 21 22 23124 25 26 27128 29 30 31 



word 6 



Real address of trapped instruction 



1 2 3 14 5 6 7 18 9 10 11112 13 14 151 16 17 18 19120 21 22 23124 25 26 27 1 28 29 30 31 

word 7 



Trapped instruction 



1 2 3 I 4 5 6 7 I 8 9 10 111 12 13 14 «l 16 17 IB I9I2O 21 22 23 1 24 25 26 27 1 28 29 30 31 

word 8 



ANLZ CC 



Effective virtual address 



i 2 Tfl 5 6 7 18 9 10 111 12 13 14 IS 1 16 17 18 19l 20 21 22 23 1 24 25 26 27 1 26 29 30 31 



word 9 
















































Effective 


real address 






















12 3 


4 


5 


6 


7 


8 


9 10 llll2 13 14 


15 1 16 17 18 19I20 21 


22 


23 


24 


25 


26 


27 


28 


29 


30 


31 



where FIP, IAP, RBP, and ANLZ CC have the same mean- 
ing as for the hardware error record (X'17 1 ). 



FILE INCONSISTENCY ERROR 

This record is logged if the system detects files which are 
inconsistent in that the associated file links do not match 
or are otherwise incorrect. 

word 



Type 
X'lA' 



Length 
X'OE' 



75 



Error 
subcode 



1 2 3 I 4 5 6 7 Is 9 10 llll2 13 14 15ll6 17 18 1^(20 21 22 23124 25 26 27 1 28 29 30 3 

word 1 



Relative time 



i 2 3 I 4 5 6 7 I 8 9 10 111 12 13 14 15 1 16 17 18 I9I2O 21 22 23 1 24 25 26 27 1 28 29 30 31 

words 2 through 9 



File 



1 2 3 U 5 6 7 Is 9 10 llll2 13 14 15 1 16 17 18 1*1 26 21 22 23 1 24 25 26 27 1 28 29 36 3 

words 10 and 11 



Account number 



i 2 3~tl 5 6 7~tl 9 10 111 12 13 14 15 1 16 17 18 19 1 20 21 22 23 1 24 25 26 27! 28 29 30 3 



word 12 



Generalized disk address 



i 2 3 I 4 5 6 7 Is 9 10 111 12 13 14 15 1 16 17 18 I9I2O 21 22 23 1 24 25 26 27 1 28 29 30 31 



word 13 




ORG 


MODE 


1 2 3 1 4 5 6 7 1 8 9 10 111 12 13 14 15 


16 17 18 19l20 21 22 23l24 25 26 27 1 28 29 30 31 



ORG is set to 1 for consecutive, 2 for keyed, and 
3 for random. 

MODE is set to 1 for IN, 2 for OUT, 4 for IN OUT, 
and 8 for OUTIN. 



SOFTWARE-DETECTED SYMBIONT INCONSISTENCIES 

This record is logged if the system detects files which are 
inconsistent in that the associated file pointers do not match 
or are otherwise incorrect. 

word 



Type 
X'lB' 



Length 
X'03' 



DCT index 
of symbiont 



I 2 3 I 4 { 6 7 Is 9 tfl H t t2 t3 U tjll6 17 18 l* l ?6 21 » 23 24 25 26 27 1 M 2* 36 31 



word 1 



Relative time 



1 2 3 I 4 5 6 7 I 8 9 10 llll2 13 14 15 1 16 17 18 19 1 20 21 22 23 1 24 25 26 27 1 28 29 30 31 



word 2 



Generated disk address 



I 2 3 I 4 5 6 7 I 8 9 10 111 12 13 14 15 1 16 17 18 19! 20 21 22 23 1 24 25 26 27 1 28 29 30 31 



INSTRUCTION EXCEPTION 

This record is logged when program executions traps to lo- 
cation X'4D' on a Sigma 9 or Xerox 560 due to an instruc- 
tion exception condition. 

word 



Type 
X'lD' 



Length 
X'QA' 



123 14 567 18 9 10 11112 13 14 151*6 17 18 1*126 2122 23124 25 26 27128 2*36 31 



Trap CC 



word 1 
































































Relative 


time 


























12 3 


4 


5 


6 


7 


8 


9 


10 


11 


12 13 14 IS 1 16 


17 18 19 


20 


21 


22 


23 


24 


25 


26 


27 


28 


29 


30 


31 



words 2 and 3 



PSD word 1 



PSD word 2 



1 2 3 14 5 6 7 18 9 10 11 I 12 13 14 15 1 16 17 18 191 20 21 22 23 1 24 25 26 27 1 28 29 30 31 
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words 4 and 5 



Reserved for future use 



i 2 3 I 4 5 6 7 I 8 9 10 11 1 12 13 14 lsl 16 17 18 19l 20 21 22 23 1 24 25 26 27 1 28 29 30 31 



word 6 



Real address of trapped instruction 



12 3 14 5 6 7 I 8 9 10 111 12 13 14 15116 17 18 19 1 20 21 22 23l24 25 26 27128 29 30 31 



word 7 



Trapped instruction 



POWER ON 

This record is generated as a result of the power on trap 
associated with location X'50 1 . 

word 



Type 
X'2Q' 

1U 5 6 7 



1 2 3 14 5 

word 1 



Length 
X.'Q2' 



9 10 111 12 13 14 15 



17 18 I9T2O "21 22 23I24 25 26 27! 28 ' » " 



Relative time 



1 2 3 14 5 6 7 18 9 10 11 1 12 13 14 151 16 17 18 19l 20 21 22 23 1 24 25 26 27] 



1 2 3 14 5 6 7 18 9 10 11112 13 14 15116 17 18 19120 21 22 23124 25 26 27728 29 30 31 



word 8 



ANLZ CC 



12 3 14 5 6 7 



Effective virtual address 



8 9 10 111 12 13 14 151 16 17 18 19]20 21 22 23124 25 26 27128 29 30 31 



word 9 


















































Effective 


rea 


address 


















6 12 3 


4 


i 


6 


/ 


3 


9 


10 HI 12 13 14 


15 1 16 


17 18 I9I2O 21 


ii 23I24 


25 


26 


27 


28 


29 


30 


31 



where FIP, IAP, RBP, and ANLZ CC have the same mean- 
ings as for the hardware error record (X'17 1 ). 



LOST ENTRY INDICATOR 

This record is entered when buffering constraints make error 
logging temporarily impossible. The newest entries are lost. 

word 



Type 
X'lE' 



Length 
X'02' 



Count of entries lost 



Z I 5 3 I 4 5 6 7 I 8 9 10 111 12 13 14 15] 16 17 18 19 1 20 21 22 23I24 25 26 27I28 29 30 31 



CONFIGURATION RECORD 

This record is logged at system startup. 

word 



Type 
X'2T 



Length 
(variable) 



"S — i — 5 — 3 I 4 5 6 7 1 8 9 10 111 12 13 14 isl 16 17 18 I9I2O 21 22 23T24 "25 "26 27l 28 29 30 31 



word 1 



Relative time 



"5 1 2 3 I 4 5 6 7 I 8 9 10 111 12 13 14 15ll6 17 18 19 [ 20 21 22 23 1 24 25 26 27 1 28 29 30 31 

word 2 



Model number 




DCT index 





2 


3 14 5 6 7 18 9 10 11112 13 14 15 


lli' 17 18 19] 20 21 22 231 24 25 26 27 1 28 29 30 31 



word 3 



Alternate I/O address 



Primary I/O address 



1 2 3 I 4 5 6 7 I 8 9 10 111 12 13 14 151 16 17 18 I9I2O 21 22 23 1 24 25 26 27I28 29 30 31 

additional words 



word 1 



Relative time of last lost entry 

1 2 3 I 4 5 6 7 I 8 9 10 111 12 13 14 15l 16 17 18 I9I2O 21 22 23! 24 25 26 27 1 28 29 30 31 



DUPLICATE ENTRIES 

This record is logged if duplicate error log entries are 
generated. 

word 



Type 
X'lF' 



Length 
X'02' 



Number of entries identical 
to previous 



I 2 3 14 5 6 7 8 9 10 111 12 13 14 151 16 17 18 19T20 21 22 23124 25 26 27128 29 30 31 

word 1 



Relative time of last duplicate 



i 2 3 I 4 5 6 7 I 8 9 10 111 12 13 14 15 1 16 17 18 19 1 20 21 22 23 1 24 25 26 27 1 28 29 30 31 



Words 2 and 3 may be repeated up 
to four times. The pairs of words 
will be in order by DCT index. 
Multiple records may occur. 



i 2 3U 5 6 7 Is 9 10 111 12 13 14 ]s\ 16 17 18 19 1 20 21 22 23 1 24 25 26 27 1 28 29 30 3 



SYSTEM IDENTIFICATION 

This record is entered at system startup and recovery and is 
entered after the CONFIGURATION RECORD (type X'21 1 ). 



word 



lm 



1 2 3 14 5 6 7 



Length 
X'05' 



9 10 111 12 13 14 15 



Core size (in 
8K word blocks) 



16 17 18 19120 21 22 23 



Relative time 
resolution 

24 25 26 27 1 28 29 30 31 
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word 1 



Relative time 



i 2 3 I 4 5 6 718 9 10 111 12 13 14 15 1 16 17 18 19 1 20 21 22 23 1 24 25 26 27 ! 28 29 30 3 

word 2 



System version flags (loc 2B) 



i 2 3 U 5 6 7 I 8 9 10 11 1 12 13 14 15 1 16 17 18 19I 20 21 22 23 1 24 25 26 27 1 28 29 30 3' 



words 3 and 4 



Site identification (in EBCDIC) 



13 I 5 3~iT 5 6 7~tl 9 10 111 12 13 14 15 1 16 17 18 19 1 20 21 22 23 1 24 25 26 27 1 2S 29 30 31 

TIME STAMP 

This record is entered once each hour on the hour. 

word 



Type 
X'23' 


Length 
X'03' 


i'.}' : '':::: v <': £••; •:. yV/yV-'.v. •.••• ; ::-r"- : - : ' V 


12 3 14 5 6 7 


8 9 10 111 12 13 14 15 


1*16 17 18 191 20 21 22 23(24 25 26 27 1 28 29 30 31 



word 1 



Relative time 



in 9 10 ul 



j 2 3 14 5 6 7 UJ 9 10 111 12 13 14 15116 17 18 19l20 21 22 23 1 24 25 26 27128 29 30 31 



I 24 25 26 27 1 2 



word 2 



Year (last fwo digits; 
in binary) 



1 2 3 14 5 6 718 9 10 11112 13 14 15 



Julian day (in binary) 



word 3 (if type code = 0) 



Address of routine calling ERRLOG 



1 2 314 56 718 9 10 11112 13 14 15116 17 1B 19l 20 21 22 23124 25 26 27128 29 30 3 



1 24 25 26 27h 



word 3 (if type code = I) 



Number of graules | 

being released 



T20 i 21 22 23 T 2 



1 2 3 14 5 6 7 18 9 10 111 12 13 14 15116 17 18 19120 21 22 23124 25 26 27128 29 30 31 



REMOTE PROCESSING ERROR 

This record is logged when an error occurs in the transmis- 
sion of data to or from a remote processing workstation. 

word 



Type 
X'26* 



Length 
X'08' 



I/O address 



1 2 3 14 5 6 718 9 10 111 12 13 14 15116 17 18 19120 21 22 23124 25 26 27128 29 30 31 



word I 
































































Relative 


time 


























12 3 


4 


5 


6 


7 


8 


9 


10 


11 


12 13 14 15ll6 


17 18 19 


20 


21 


22 


23 


24 


25 


26 


27 


28 


29 


30 


31 



word 


2 
















































RBrFLAGS 


1 2 


3 


4 


5 


6 


7 


B 


9 


10 


11 


12 


13 14 151 16 17 18 


19 


20 


21 


22 


23 


24 


25 


26 


27 


28 


29 


30 


31 



words 3 and 4 



Workstation name 



16 17 18 19I20 21 22 23124 25 26 27 1 28 29 30 31 



II 1 2 i\i 5 6 7U 9 10 )l l l2 13 U 15 l l6 17 18 ij l fl 21 22 fcl l 24 25 26 27^ 29 30 M 



BAD GRANULE RELEASE 

This record is logged if the granule being released contains 
an invalid disk address or has already been released (dual 
allocation). 

word 



x*» 



12 3 14 5 6 7 



Length 
X'04' 



9 10 111 12 13 14 15 



Type code (0-bad address; 
1-dual allocation) 



17 18 19I2O 21 22 23I24 25 26 27 1 28 29 X 31 



word 1 



Relative time 



12 3 14 5 6 7 



10 111 12 13 14 IS I 16 17 18 19 1 20 21 22 23 1 24 25 26 27 1 28 29 30 31 



word 2 



Generated disk address 



1 2 314 5 6 7TB 9 10 111 12 13 14 15 1 16 17 18 19120 21 22 23124 25 26 27 1 28 29 30 31 



words 5 and 6 



Current command doubleword 



i 2 3 I 4 5 6 7 I 8 9 10 111 12 13 14 15I16 17 18 19 1 20 21 22 23 1 24 25 26 27I28 29 30 



word 7 










RP1 


RP2 


RP3 


RP4 


1 2 3 U 5 


6 7 


B 9 10 11 1 12 13 14 15 


16 17 18 19i20 21 22 23 


24 25 26 27 1 28 29 30 31 



where 

type identifies the type of error log record. 

length specifies the number of 32-bit words con- 
tained in the error log record. 

I/O address is a 16-bit address representing the 

physical I/O address. 

relative time represents milliseconds since mid- 
night. Resolution is 2 msec. 
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RB:FLAGS specifies the contents of RB:FLAG at the 
time of the error. RBrFLAG is described in the 
CP-V/Data Base Technical Manual, 90 19 95. 

workstation name specifies the workstation name 
(in TEXT format, left-justified and padded with 
blanks) if the terminal is logged on. 

current command doubleword specifies the command 
doubleword of the i/Othat was taking place when 



the error occurred. For Xerox 7670 RBTs, the 
current command doubleword contains the second 
command doubleword used to write the text of an 
output message and is meaningful only for RP1 =0, 
1, A, or B. 

RP1, RP2, RP3, and RP4 have specific meaning for 
the type of remote workstation associated with the 
record. The meanings are listed in Tables E-2 
through E-7. 



Table E-2. Xerox 7670 RBT - RP1, RP3, and RP4 



RP1 Value 


Meaning 


Corresponding RP3 Meaning 


Corresponding RP4 Meaning 


1 


First character in record not SOH. 


Current character position. 


Offending character. 


2 


Incorrect parity on SEL. 


Current character position. 


Offending character. 


3 


Incorrect block protect. 


Current character position. 


Offending character. 


4 


Third character in record not STX. 


Current character position. 


Offending character. 


5 


RBBAT COMBUF or MPOOL unavailable 
for log-on. 


Meaningless. 


Meaningless. 


6 


Incorrect character parity. 


Current character position. 


Offending character. 


7 


Record trailer character not ETX. 


Current character position. 


Offending character. 


8 


Incorrect block check parity. 


Current character position. 


Offending character. 


9 


Incorrect block check. 


Current character position. 


Offending character. 


A 


Communication line time-out. 


Meaningless. 


Meaningless. 


B 


NAK received. 


Response received reading for 
to be a halfword). 


ACK. (RP3 and RP4 combine 


C 


Garbled AC K or NAK. 


Response received reading for 
to be a halfword). 


ACK. (RP3 and RP4 combine 
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Table E-3. Xerox 7670 RBT - RP2 



Table E-4. IBM 2780 RBT - RPl and RP4 



RP2 Value 


Meaning (Current Function Code) 





Write card punch. 


1 


Write line printer. 


2 


Send ACK. 


3 


Write TOF (Block protect = 0). 


4 


Write TOF (Block protect = 1). 


5 


Write SPACE (Block protect = 0). 


6 


Write SPACE (Block protect = 1). 


7 


Read card reader. 


8 


Write TOF (log-on). 


9 


Read card reader (special). 


A 


Read ACK card punch. 


B 


Read ACK line printer. 


C 


Read ACK TOF (Block protect = 0). 


D 


Read ACK TOF (Block protect - 1). 


E 


Read ACK SPACE (Block protect = 0). 


F 


Read ACK SPACE (Block protect = 1). 


10 


Write EOT. 


11 


Write DC1. 


12 


Write ACK (special). 


13 


Write NAK. 


14 


Write NAK (special). 


15 


Write BEL (on error). 



RPl 
Value 


Meaning 


Corresponding RP4 
Meaning 


1 


Disconnect due to 






a. EOT on read. 


EOT 




b. Use of 2780 on 
IRBT only system. 


ENQ 


2 


Line timeout. 


Same as RP2. 


3 


ENQ not received 
on logon read. 


Character received. 


4 


NoEOTafterEOFsent. 


Character received. 


5 


a. ENQ in text mode. 


Character received. 




b. No ENQ answer- 
ing WACK. 


Character received. 




c. ENQ answer to 
ACK of EOF. 


Character received. 


6 


NAK received. 


Character received. 


8 


CRC failed on input. 


Last character 
CRCed. 


9 


Unknown response 
reading for ACK. 


Character received. 


A 


Trailer character not 
ETB or ETX. 


Character received. 


C 


Header character not 
STX. 


Character received. 



Table E-5. IBM 2780 RBT - RP2 and RP3 



Value 


RP2 (Current Function Code) 


RP3 (Calling Function Code) 





Disconnect. 


Software error — should not occur. 


1 


Write data. 


Write. 


2 


Send ENQ. 


Send ENQ (Wait). 


3 


Send ACK O. 


Read. 


4 


Send WACK. 


Send WACK (Wait). 
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Table E-5. IBM 2780 RBT - RP2 and RP3 (cont. ) 


Value 


RP2 (Current Function Code) 


RP3 (Calling Function Code) 


5 


Write data. 


Write EOF. 


6 


Send ENQ. 


Request to output. 


7 


Read for ACK, ENQ, EOT (depends on RP3). 


POL for input. 


8 


Read for ENQ. 


Logon. 


9 


Read. 


Software error — should not occur. 


A 


Send NAK. 


Software error — should not occur. 


B 


Send AC K 1. 


Software error — should not occur. 


C 


Send EOT. 

— 


Software error — should not occur. 



Table E-6. IRBT - RPl and RP4 



RPl 
Value 


Meaning 


Corresponding RP4 Meaning 





Recoverable block check error. 


Difference (mod 256) between 
and received BCBs. 


expected 


1 


Catastrophic block check error (no retries 
attempted). 


Difference (mod 256) between 
and received BCBs. 


expected 


2 


Communication line time-out. 


Same as RP2. 




3 


Read for ENQ timed-out (logon). 


Same as RP2. 




4 


Received ACK O instead of SIGNON at logon. 


ACK O 




5 


Inappropriate line bid (not ENQ-master, not 
ACK O-slave). 


Line bid received. 




6 


NAK received. 


NAK. 




7 


Read timed out. 


Same as RP2. 




8 


Incorrect CRC. 


Last character CRCed. 




9 


Trailer character not ETB. 


Offending character. 




A 


Leader character not STX. 


Offending character. 




B 


Lost data. 


First character after IDLE. 




C 


Garbled ACK O-NAK. 


First character of message. 
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Table E-7. IRBT - RP2 


and RP3 


Value 


RP2 (Current Function Code) 


RP3 (Calling Function Code) 





Disconnect. 


Software error — should not occur. 


1 


Write block. 


Write block — read block. 


2 


Write AC K. 


Write ACK - read block. 


3 


Write block. 


Write block (Wait-a-bit) — Read special. 


4 


Write Wait-a-bit. 


Write Wait-a-bit — Read special. 


5 


Read block. 


Software error — should not occur. 


6 


Send NAK. 


Software error — should not occur. 


7 


Send ENQ. 


Logon as Slave. 


8 


Read for ENQ. 


Logon as Master. 


9 


ACK O to ENQ. 


Logon as Master after ENQ Read. 


A 


Read logon record. 


Software error — should not occur. 


B 


NAK logon record. 


Software error — should not occur. 



OPERATOR MESSAGE 

This record is interjected as the resultofan operator ERRS END 
key-in or by a diagnostic program. It is generally used to de- 
scribe unusual conditions surrounding a particular error. 



word 1 



word 




Type 
X'27' 


Length 1' ' s 
(variable) 1 ' ;•].'• •'. 


1 2 3 1 4 5 6 7 


8 9 10 1)1 12 13 14 15116 17 18 I9I2O 21 22 23124 25 26 27I28 29 30 31 



word 1 



Relative time 



1 2 3 I 4 5 6 71 8 9 10 111 12 13 14 15116 17 18 19t 20 21 22 23124 25 26 27128 29 30 31 



word 2 



Message from the operator in TEXTC 
format. (Maximum size is 71 characters 
p.lus the count byte.) 



i 2 3 I 4 5 6 7~fl 9 10 1 1 1 12 13 14 I5I16 17 18 19 1 20 21 22 23 1 24 25 26 27 1 28 29 30 3 

I/O ACTIVITY COUNT 

This is recorded once per hour and at recovery, 
word 



Type 
X'28' 


Length 
(variable) 


DCT index of first device 


1 2 3 U 5 6 7 


8 9 10 111 12 13 14 15 


16 17 IB 19120 21 22 23124 25 26 27 1 28 29 30 31 



Relative time 



T 2 3 I -4 5 6 7 t 8 9 10 11 1 12 13 14 15 1 16 17 18 I9I2O 21 22 23! 24 25 26 27 1 28 29 30 31 

word 2 



I/O address 



DCT index 



1 2 3 14 5 6 7 18 9 10 11 I 12 13 14 151 16 17 18 191 20 21 22 231 24 25 26 271 28 29 30 31 

word 3 



I/O count 



i 2 3 i 4 5 6 7 Is 9 10 111 12 13 14 15ll6 17 18 l?l 20 21 22 23 1 24 25 26 27 1 28 29 30 31 

additional words 



Words 2 and 3 may be repeated up to four 
times. The pairs of words will be in order 
by DCT index. Multiple records may occur. 



i 2 3 I 4 5 6 7TI 9 10 111 12 13 14 I5I16 17 18 19l 20 21 22 23 1 24 25 26 27 1 28 29 30 3 



PFI PRIMARY RECORD 

This record is logged when program execution is inter- 
rupted to location X'56' on the Xerox 560 due to a Pro- 
cessor Fault Interrupt condition. 

word 



Type 
X'30' 


Length 
X'02' 




1 2 3 1 4 5 6 7 


8 9 10 111 12 13 14 15 


16 17 18 I9I2O 21 22 23f24 25 26 27 1 28 29 30 31 
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word 1 



Relative time 



1 2 3 14 5 6 7 18 9 10 1H12 13 14 15l 16 17 18 19120 21 22 23124 25 26 27 1 28 29 30 31 



word 2 



Memory status word 



7S 1 2" 3 I 4 5 6 7 Is 9 10 111 12 13 14 15 1 16 17 18 19l 20 21 22 23 1 2-4 25 26 27 1 28 29 30 



MFI PRIMARY RECORD 

This record is logged as a result of the memory fault in- 
terrupt associated with location X'57' on a Sigma 9 or 
Xerox 560. 

word 



Type 
X'31' 


Length 
X'02' 


.... ....... .... . - : .,; :,••.:•■■)■ ...... ,.,,.,,;.■.;. .-:-,!-,.-, ,,.,., 


1 2 3 1 4 5 6 7 


8 9 10 111 12 13 14 15 


16 17 18 19120 21 22 23T24 25 26 27I28 29 30 31 



word 1 



Relative time 



1 2 3 i 4 5 6 ?\b 9 10 111 12 13 14 15 1 16 17 18 19 i 20 21 22 23 1 24 25 26 27 1 28 29 30 3 



SECONDARY RECORD FOR POLL INFORMATION 

This record is logged to record specific information obtained 
by issuing a POLL instruction subsequent to detecting hard- 
ware errors. One record is produced per valid poll status 
received. 

word 



Type 
'32' 



X 



1 2 TT4 5 6 7 



Length 
X'03' 



9 10 HTl2 13 14 15 



17 18 I9I2O 21 22 2)1 24 25 26 27 1 28 29 30 31 



word 1 



Relative time 

1 2 3 I 4 5 6 7 I 8 9 10 111 12 13 14 15l 16 17 18 19 1 20 21 22 23 1 24 25 26 27 1 28 29 30 31 



word 3 



Memory status word 1 



1 2 3 14 5 6 7 18 9 10 1H12 13 14 15M6 17 18 19120 21 22 23124 25 26 27 1 28 29 30 31 



MEMORY PARITY SECONDARY RECORD 

This record is logged as a result of the memory fault inter- 
rupt associated with location X'57' or the memory parity 
trap associated with location X'4C' on the Sigma 9 or 
Xerox 560. This record follows record type X'17' and 
record type X'31'. 

word 



Type 
X'43' 



Length 
X'05" 



~6 j 2 3 14 5 6 7 18 9 10 111 12 13 14 151 W 17 18 I9I2O 21 22 23 [24' 25 26 27 1 28 29 30 31 

word 1 



Relative time 



1 2 3 I 4 5 6 7 I 8 9 10 111 12 13 14 15 1 16 17 18 19120 21 22 23124 25 26 27 1 28 29 30 31 



word 2 



Memory status word 



i 2 3 I 4 5 6 7U 9 10 111 12 13 14 15 1 16 17 18 19 1 20 21 22 23 1 24 25 26 27 1 28 29 30 31 



word 3 



Memory status word 1 



ll 12 13 14 lsl 



1 2 3 14 5 6 7 18 9 10 11M2 13 14 15 1 16 17 18 19 1 20 21 22 23124 25 26 27128 29 30 31 



word 4 



Memory status word 2 



1 2 314 5 6 7 I 8 9 10 11 I 12 13 14 15116 17 18 19120 21 22 23124 25 26 27128 29 30 31 



word 2 










Unit 
address 


Poll 
CC 


Unit 
type 


Poll status 


1 


2 3 U 5 6 7 


8 9 10 11 


12 13 14 15 


16 17 18 19l20 21 22 23I24 25 26 27 i 28 29 30 31 



XEROX 560 MEMORY PARITY SECONDARY RECORD 

This record is logged to record specific information re- 
turned in response to an LMS instruction subsequent to 
detecting hardware errors. 

word 



Type 
X'42' 



12 3 14 5 6 7 



Length 
X'04' 

10 111 12 13 14 15 



■'■•■ ■ ■ ■ r ■ — ■ — -+• — . mm. .1 inin 

17 18 19120 21 22 23124 25 26 27128 29 30 31 



SIGMA 6/7 MEMORY PARITY SECONDARY RECORD 

This record is logged to record specific information obtained 
by scanning memory to attempt to isolate locations which 
cannot sustain correct parity. 



word 






Type 
X'44' 


Length 
X'03' 






1 2 3 U 5 6 7 


8 9 10 111 12 13 14 15 


16 17 18 19120 21 22 23l 24 25 26 27 1 28 29 30 31 



word 1 


































































Relat 


ve 


time 


























12 3 


4 


5 


6 


7 


8 


9 


10 


11 


12 13 14 


5I 16 


17 16 19 


20 


21 


22 


23 


24 


25 


26 


27 


28 


29 


30 


31 



word 1 
































































Relative 


time 


























12 3 


4 


5 


6 


7 


8 


9 


10 


11 


12 13 14 15 1 16 


17 18 19 


20 


21 


22 


23 


24 


25 


26 


27 


28 


29 


30 


31 



word 2 



Bad location 



12314567189 10 11M2 13 14 15116 17 18 19] 20 21 22 23124 25 26 27 1 28 29 30 31 
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ENQUEUE TABLE OVERFLOW 

This record is logged when an Enqueue CAL has been 
rejected because there are insufficient unused entries in 
the Enqueue tables. 

word 



Type 
X'50 1 



Length 
X'03' 



1 2 3 I 4 5 6 7~I 8 9 10 111 12 13 14 15 1 16 17 16 iiTJo 2l" 22 23T24 25 26 27! 28 29 30 31 

word 1 



Relative time 



"5 1 2 3 I 4 5 6 7 1 8 9 10 111 12 13 14 I5I16 17 18 19 ! 20 21 22 23 1 24 25 26 27 1 28 29 30 31 

word 2 



User ID 



Entry count (in binary) 



1 2 3 I 4 5 6 7 I 8 9 10 111 12 13 14 15116 17 18 19120 21 22 23124 25 26 27128 29 30 3 

Entry count is the number of entries in the enqueue table be- 
longing to the specified user at the time the error log entry 
was made. 



PARTITIONED RESOURCE 

This entry is logged when a resource is partitioned via 
the SYSCON processor by the operator. 

word 



Type 
X'51 



Length 
X'03 1 



Model number 



i 2 3 I 4 5 6 7 ! 8 9 10 111 12 13 14 151 16 17 18 19 1 20 2) 22 23 1 24 25 26 27 1 28 29 30 31 



word 1 








Relative time 


B 1 J 3 \i 


6 7 18 9 10 


li 12 13 14 151 16 17 18 19 i 20 21 22 2 


3124 25 26 27128 29 30 31 



word 2 






F 








I/O address 


<F 


1 2 3 14 5 6 7 1 8 


10 111 12 13 14 15 


16 17 IB I9I2O 21 22 23 1 24 25 26 271 28 29 30 31 



where 

F = for device entry. 
F = 1 for controller entry. 

RETURNED RESOURCE 

This entry is logged when a resource is returned from being 
partitioned via the SYSCON processor by the operator. 

word 



Type 
X'52' 



Length 
X'03' 



Model number 



1 2 3 14 5 6 718 9 10 11112 13 14 15116 17 18 19120 21 22 23124 25 26 27T28 29 30 3 



word 1 
































































Relative 


time 


























12 3 


4 


5 


6 


7 


8 


9 


10 


11 


12 13 14 15ll6 


17 18 19 


20 


21 


22 


23 


24 


25 


26 


27 


28 


29 


30 


31 



word 2 



0- 



1 2 3l4 5 6 7 18 9 10 11 1 12 13 14 15 



I/O address 



16 17 18 19120 21 22 23124 25 26 27128 29 30 3! 



/her 



F = for device entry. 
F = 1 for controller entry. 
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APPENDIX F. XEROX STANDARD OBJECT LANGUAGE 



INTRODUCTION 

GENERAL 

The Xerox standard object language provides a means of 
expressing the output of any Xerox processor in standard 
format. All programs and subprograms in this object format 
can be loaded by the Monitor's relocating loader. Such a 
loader is capable of providing the program linkages needed 
to form an executable program in core storage. The object 
language is designed to be both computer-independent and 
medium-independent; i. e., it is applicable to any Xerox 
computer having a 32-bit word length, and the same format 
is used for both cards and paper tape. 



SOURCE CODE TRANSLATION 

Before a program can be executed by the computer, it must 
be translated from symbolic form to binary data words and 
machine instructions. The primary stages of source program 
translation are accomplished by a processor. However, under 
certain circumstances, the processor may not be able to trans- 
late the entire source program directly into machine language 
form. 

If a source program contains symbolic forward references, a 
single-pass processor such as the Xerox Symbol assembler can 
not resolve such references into machine language. This is be- 
cause the machine language value for the referenced symbol 
is not established by a one-pass processor until after the state- 
ment containing the forward reference has been processed. 

A two-pass processor, such as the Xerox Meta-Symbol assem- 
bler, is capable of making "retroactive" changes in the 
object program before the object code is output. Therefore, 
a two-pass processor does not have to output any special 
object codes for forward references. An example of a for- 
ward reference in a Symbol source program is given below. 



Y 



EQU $ + 3 



CI, 5 
LI, R 

EQU 
BG 



In this example the operand $ + 3 is not a forward reference 
because the assembler can evaluate it when processing the 
source statement in which it appears. However, the oper- 
and Z in the statement 



CI,5 



is a forward reference because it appears before Z has been 
defined. In processing the statement, the assembler outputs 
the machine-language code for CI,5, assigns a forward ref- 
erence number (e.g., 12) to the symbol Z, and outputs that 
forward reference number. The forward reference number 
and the symbol Z are also retained in the assembler's symbol 
table. 

When the assembler processes the source statement 

LI,R Z 

it outputs the machine-language code for LI, assigns a for- 
ward reference number (e.g., 18) to the symbol R, outputs 
that number, and again outputs forward reference number 
12 for symbol Z. 

On processing the source statement 

Z EQU 2 

the assembler again outputs symbol Z's forward reference 
number and also outputs the value, which defines symbol Z, 
so that the relocating loader will be able to satisfy refer- 
ences to Z in statements CI, 5 Z and LI,R Z. At this time, 
symbol Z's forward reference number (i.e., 12) may be 
deleted from the assembler's symbol table and the defined 
value of Z equated with the symbol Z (in the symbol table). 
Then, subsequent references to Z, as in source statement 



BG 



would not constitute forward references, since the assembler 
could resolve them immediately by consulting its symbol 
table. 

If a program contains symbolic references to externally 
defined symbols in one or more separately processed subpro- 
grams or library routines, the processor will be unable to 
generate the necessary program linkages. 

An example of an external reference in a Symbol source pro- 
gram is shown below. 



EQU Z + 1 



REF 



LI, 3 



ALPH 



ALPH 



Although a discussion of the object language is not directly 
pertinent to CP-V, it is included in this manual because it 
applies to some of the processors operating under CP-V. 



When the assembler processes the source statement 
REF ALPH 
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it outputs the symbol ALPH, in symbolic (EBCDIC) form, in 
a declaration specifying that the symbol is an external ref- 
erence. At this time, the assembler also assigns a declara- 
tion name number to the symbol ALPH but does not output 
the number. The symbol and name number are retained in 
the assembler's symbol table. 

After a symbol has been declared an external reference, it 
may appear any number of times in the symbolic subprogram 
in which it was declared. Thus, the use of the symbol 
ALPH in the source statement 

LI, 3 ALPH 

in the above example, is valid even though ALPH is not 
defined in the subprogram in which it is referenced. 

The relocating loader is able to generate interprogram link- 
ages for any symbol that is declared an external definition 
in the subprogram in which that symbol is defined. Shown 
below is an example of an external definition in a Symbol 
source program. 



DEF 



ALPH 



for their representation, depending on the type and specific 
content of each item. A group of 108 bytes, or fewer, com- 
prises a' logical record. A load item may be continued from 
one logical record to the next. 

The Ordered set of logical records that a processor generates 
for a program or subprogram is termed an "object module". 
The end of an object module is indicated by a module-end 
type code followed by the error severity level assigned to 
the module by the processor. 

RECORD CONTROL INFORMATION 

Each record of an object module consists of 4 bytes of con- 
trol information followed by a maximum of 104 bytes of load 
information. That is, each record, with the possible excep- 
tion of the end record, normally consists of 108 bytes of 
information (i.e., 72 card columns). 

The four bytes of control information for each record have 
the form and sequence shown below. 

Byte 



LI, 3 ALPH 



Record Type 


Mode 


Format 




1 1 


1 



ALPH AI,4 X'F2' 

When the assembler processes the source statement 

DEF ALPH 

it outputs the symbol ALPH, in symbolic (EBCDIC) form, in 
a declaration specifying that the symbol is an external defi- 
nition. At this time, the assembler also assigns a declaration 
name number to the symbol ALPH but does not output the 
number. The symbol and name number are retained in the 
assembler's symbol table. 

After a symbol has been declared an external definition it 
may be used (in the subprogram in which it was declared) in 
the same way as any other symbol. Thus, if ALPH is used as 
a forward reference, as in the source statement 



LI, 3 



ALPH 



above, the assembler assigns a forward reference number to 
ALPH, in addition to the declaration name number assigned 
previously. (A symbol may be both a forward reference and 
an external definition.) 

On processing the source statement 

ALPH Al,4 X'F2' 

the assembler outputs the declaration name number of the 
label ALPH (and an expression for its value) and also outputs 
the machine-language code for AI, 4 and the constant X'F2'. 

OBJECT LANGUAGE FORMAT 

An object language program generated by a processor is out- 
put as a string of bytes representing "load items". A load 
item consists of an item type code followed by the specific 
load information pertaining to that item. (The detailed format 
of each type of load item is given later in this appendix.) 
The individual load items require varying numbers of bytes 



Byte 1 



Sequence Number 




Byte 2 



Checksum 



Byte 3 



Record Size 



7 

Record Type specifies whether this record is the last 
record of the module: 

000 means last 

001 means not last 

Mode specifies that the loader is to read binary infor- 
mation. This code is always 11. 

Format specifies object language format. This code is 
always 100. 

Sequence Number is for the first record of the module 

and is incremented by 1 for each record thereafter, 
until it recycles to after reaching 255. 

Checksum is the computed sum of the bytes comprising 
the record. Carries out of the most significant bit 
position of the sum are ignored. 

Record Size is the number of bytes (including the record 

control bytes) comprising the logical record (5 < record 
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size < 108). The record size will normally be 108 bytes 

for all records except the last one, which may be fewer. 
Any excess bytes in a physical record are ignored. 

LOAD ITEMS 

Each load item begins with a control byte that indicates the 
item type. In some instances, certain parameters are also 
provided in the load item control byte. In the following dis- 
cussion, load items are categorized according to their function: 

1. Declarations identify to the loader the external and 
control section labels that are to be defined in the 
object module being loaded. 

2. Definitions define the value of forward references, 
external definitions, the origin of the subprogram being 
loaded, and the starting address (e.g., as provided in 

a Symbol/Meta -Symbol END directive). 

3. Expression evaluation load items within a definition 
provide the values (such as constants, forward refer- 
ences, etc.) that are to be combined to form the final 
value of the definition. 



4. Loading items cause specified information to be stored 
5. 



into core memory. 

Miscellaneous items comprise padding bytes and the 



module-end indicator. 

DECLARATIONS 

In order for the loader to provide the linkage between subpro- 
grams, the processor must generate for each external refer- 
ence or definition a load item, referred to as a "declaration", 
containing the EBCDIC code representation of the symbol 
and the information that the symbol is either an external ref- 
erence or a definition (thus, the loader will have access to 
the actual symbolic name). 

Forward references are always internal references within an 
object module. (External references are never considered 
forward references.) The processor does not generate a dec- 
laration for a forward reference as it does for externals; how- 
ever, it does assign name numbers to the symbols referenced. 



Declaration name numbers (for control sections and external 
labels) and forward reference name numbers apply only within 
the object module in which they are assigned. They have no 
significance in establishing interprogram linkages, since 
external references and definitions are correlated by match- 
ing symbolic names. Hence, name numbers used in any 
expressions in a given object module always refer to symbols 
that have been declared within that module. 



The processor must generate a declaration for each symbol 
that identifies a program section. Each object module pro- 
duced by an assembler is considered to consist of at least 
one control section. If no section is explicitly identified 
in the source program, the assembler assumes it to be a 
standard control section (discussed below). The standard 
control section is always assigned a declaration name 



number of 0. All other control sections (i.e., produced by 

a processor capable of declaring other control sections) are 
assigned declaration name numbers (1, 2, 3, etc.) in the 
order of their appearance in the source program. 

In the load items discussed below, the access code, pp, des- 
ignates the memory protection class that is to be associated 
with the control section. The meaning of this code is given 
below. 



PP 


Memory Protection Feature' 


00 


Read, write, or access instructions from. 


01 


Read or access instructions from. 


10 


Read only. 


11 


No access. 



Control sections are always allocated on a doubleword 
boundary. The size specification designates the number of 
bytes to be allocated for the section. 

Declare Standard Control Section 

Byte 



Control byte 











1 


1 


1 




Byte 1 



Access code 




Size (bits 1 through 4) 


P P 









Byte 2 



4 5 



Size (bits 5 through 12) 




Byte 3 



Size (bits 13 through 20) 







This item declares the standard control section for the object 
module. There may be no more than one standard control 
section in each object module. The origin of the standard 
control section is effectively defined when the first reference 
to the standard control section occurs, although the declara- 
tion item might not occur until much later in the object 
module. 



"Read" means a program can obtain information from the 
protected area; "write" means a program can store informa- 
tion into a protected area; and, "access" means the compu- 
ter can execute instructions stored in the protected area. 
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This capability is required by one-pass processors, since 
the size of a section cannot be determined until all of 
the load information for that section has been generated by 
the processor. 

Dec I a r e Nonstandard Control Section 
Byte 



Declare Dummy Section 
Byte 









Control 


byte 














110 



Byte 1 


1 


2 


3 


4 5 6 7 


Access 


code 




Size (bits 1 through 4) 


P 


P 











Byte 2 


1 


2 


3 


4 7 


Size (bits 5 through 12) 





Byte 3 








7 






Size 


(bits 13 rt 


i rough 20) 





This item declares a control section other than standard con- 
trol section (see above). 



Control byte 








10 




1 



Byte 1 


1 


2 3 4 5 




6 7 


First byte of name number 





Byte 2 








7 


Second byte of name number 





Byte 3 








7 


Access 


code 




Size (bits 


1 th 


rough 4) 


P 


P 








Byte 4 






Size (bits 5 through 12) 





Byte 5 




7 


Size (bits 13 through 20) 





Declare Page Boundary Control Section 
Byte 



Control Byte 





11110 


1 
Byte 1 


2 3 4 5 6 7 


Access code 




Size (bits 1 through 4) 


P P 







1 
Byte 2 


2 3 4 5 6 7 


Size (bits 5 through 12) 





Byte 3 


7 


Size (bits 13 through 20) 





This item declares a nonstandard control section beginning 
on a memory page boundary. 



This item comprises a declaration for a dummy control sec- 
tion. It results in the allocation of the specified dummy 
section, if that section has not been allocated previously 
by another object module. The label that is to be associ- 
ated with the first location of the allocated section must be 
a previously declared external definition name. (Even 
though the source program may not be required to explicitly 
designate the label as an external definition, the processor 
must generate an external definition name declaration for 
that label prior to generating this load item.) 

Declare External Definition Name 
Byte 



Control byte 











1 


1 



Byte 1 


1 


2 3 4 5 


6 


7 


Name length, in bytes (K) 









If the module has fewer than 256 previously assigned name 
numbers, this byte is absent. 
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Byte 2 



First byte of name 





Byte K+l 




7 


Last byte of name 


— 



7 

This item declares a label (in EBCDIC code) that is an exter- 
nal definition within the current object module. The name 
may not exceed 63 bytes in length. 

Declare Primary External Reference Name 



Byte 










Control byte 








1 





1 



Byte 1 


1 


2 3 4 5 


6 


7 


Name length (K), in bytes 






Byte 2 



First byte of name 



Byte K+l 



Last byte of name 



This item declares a symbol (in EBCDIC code) that is a pri- 
mary external reference within the current object module. 
The name may not exceed 63 bytes in length. 

A primary external reference is capable of causing the loader 
to search the system library for a corresponding external 
definition. If a corresponding external definition is not 
found in another load module of the program or in the system 
library, a load error message is output and the job is errored. 

Declare Secondary External Reference Nam e 
Byte 







Control byte 











Byte 1 



Name length, in bytes (K) 



Byte 2 






First byte of name 





Byte K+l 




7 


Last byte of name 





7 

This item declares a symbol (in EBCDIC code) that is a sec- 
ondary external reference within the current object module. 
The name may not exceed 63 bytes in length. 

A secondary external reference is not capable of causing the 
loader to search the system library for a corresponding exter- 
nal definition. If a corresponding external definition is not 
found in another load module of the program, the job is not 
errored and no error or abnormal message is output. 

Secondary external references often appear in library routines 
that contain optional or alternative subroutines, some of which 
may not be required by the user's program. By the use of pri- 
mary external references in the user's program, the user can 
specify that only those subroutines thatare actually required by 
the current job are to be I oaded. Al though secondary externa I 
references do not cause loading from the library, they do cause 
linkages to be made between routines that are loaded. 



DEFINITIONS 

When a source language symbol is to be defined (i.e., equa- 
ted with a value), the processor provides for such a value by 
generating an object language expression to be evaluated by 
the loader. Expressions are of variable length, and terminate 
with an expression-end control byte (see "Expression Evalua- 
tion" in this appendix). An expression is evaluated by the ad- 
dition or subtraction of values specified by the expression. 

Since the loader must derive values for the origin and start- 
ing address of a program, these also require definition. 

Origin 



Byte 












Control byte 











1 









This item sets the loader's load-location counter to the 
value designated by the expression immediately following 
the origin control byte. This expression must not contain 
any elements that cannot be evaluated by the loader (see 
"Expression Evaluation" which follows). 

Forward Reference Definition 



Byte 












Control byte 








1 
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Byte 1 








First byte of reference number 







Byte 2 




7 


Second byte of reference number 





Byte 2 



7 

This item defines the value (expression) for a forward refer- 
ence. The referenced expression is the one immediately 
following byte 2 of this load item, and must not contain 
any elements that cannot be evaluated by the loader (see 
"Expression Evaluation" which follows). 



Forward Reference Definition and Hold 



Byte 










Control byte 








10 









Byte 1 


1 


2 3 4 5 


6 


7 


First byte of reference number 





Byte 2 








7 


Second byte of reference number 









This item defines the value (expression) for a forward refer- 
ence and notifies the loader that this value is to be retained 
in the loader's symbol table until the module end is encoun- 
tered. The referenced expression is the one immediately 
following the name number. It may contain values that have 
not been defined previously, but all such values must be 
available to the loader prior to the module end. 

After generating this load item, the processor need not retain 
the value for the forward reference, since that responsibility 
is then assumed by the loader. However, the processor must 
retain the symbolic name and forward reference number 
assigned to the forward reference (until module end). 



Second byte of name number* 



This item defines the value (expression) for an external 
definition name. The name number refers to a previously 
declared definition name. The referenced expression is 
the one immediately following the name number. 



Define Start 



Byte 



Control byte 







1 



This item defines the starting address (expression) to be used 
at the completion of loading. The referenced expression is 
the one immediately following the control byte. 



EXPRESSION EVALUATION 

A processor must generate an object language expression 
whenever it needs to communicate to the loader one of 
the following: 

1. A program load origin. 

2. A program starting address. 

3. An external definition value. 

4. A forward reference value. 

5. A field definition value. 



Such expressions may include sums and differences of con- 
stants, addresses, and external or forward reference values 
that, when defined, will themselves be constants or addresses. 



External Definition 



Byte 



Control byte 








10 


1 






Byte 1 


1 


2 3 4 5 


6 


7 


First byte of name number 





After initiation of the expression mode, by the use of a con- 
trol byte designating one of the five items described above, 
the value of an expression is expressed as follows: 

1. An address value is represented by an offset from the 
control section base plus the value of the control sec- 
tion base. 



If the module has fewer than 256 previously assigned name 
numbers, this byte is absent. 
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The value of a constant is added to the accumulated 
sum by generating an Add Constant (see be low) control 
byte followed by the value, right- justified in four 
bytes. 

The offset from the control section base is given as a 
constant representing the number of units of displace- 
ment from the control section base, at the resolution 
of the address of the item. That is, a word address 
would have its constant portion expressed as a count 
of the number of words offset from the base, while the 
constant portion of a byte address would be expressed 
as the number of bytes offset from the base. 

The control section base value is accumulated by means 
of an Add Value of Declaration (see below)or Subtract 
Value of Declaration load item specifying the desired 
resolution and the declaration number of the control 
section base. The loader adjusts the base value to the 
specified address resolution before adding it to the cur- 
rent partial sum for the expression. 

In the case of an absolute address, an Add Absolute 
Section (see below) or Subtract Absolute Section con- 
trol byte must be included in the expression to identify 
the value as an address and to specify its resolution. 



An external definition of forward reference value is 
included in an expression by means of a load item add- 
ing or subtracting the appropriate declaration or for- 
ward reference value. If the value is an address, 
the resolution specified in the control byte is used to 
align the value before adding it to the current partial 
sum for the expression. If the value is a constant, no 
alignment is necessary. 



Change Expression Resolution control byte occurs, then 
the expression resolution is unaffected. 



Note that the expression for a program load origin or 
starting address must resolve to a simple address, and the 
single nonzero resolution counter must have a final count 
of +1 when such expressions are evaluated. 



In converting a byte address to a word address, the two least 
significantbits of the address are truncated. Thus, if the 
resulting word address is later changed back to byte resolu- 
tion, the referenced byte location will then be the first byte 
(byte 0) of the word. 



After an expression has been evaluated, its final value is 
associated with the appropriate load item. 



In the following diagrams of load item formats, RR refers to 
the address resolution code. The meaning of this code is 
given in the table below. 



RR 


Address Resolution 


00 
01 
10 
11 


Byte 

Halfword: 
Word 
Doubleword 



Expressions are not evaluated by the loader until all re- 
quired values are available. In evaluating an expression, 
the loader maintains a count of the number of values added 
or subtracted at each of the four possible resolutions. A 
separate counter is used for each resolution, and each 
counter is incremented or decremented by 1 whenever a 
value of the corresponding resolution is added to or sub- 
tracted from the loader's expression accumulator. The final 
accumulated sum is a constant, rather than an address 
value, if the final count in all four counters is equal to 0. 
If the final count in one (and only one) of the four counters 
is equal to +1 or -1, the accumulated sum is a "simple ad- 
ress" having the resolution of the nonzero counter. If 
more than one of the four counters hava a nonzero final 
count, the accumulated sum is termed a "mixed-resolution 
expression" and is treated as a constant rather than an 
address. 



The load item discussed in this appendix, "Expression 
Evaluation", may appear only in expressions. 

Add Constant 



Byte 












Control byte 

















1 




Byte 1 



First byte of constant 



The resolution of a simple address may be altered by 
means of a Change Expression Resolution (see below) 
control byte. However, if the current partial sum is 
either a constant or a mixed-resolution value when the 



Byte 2 



Second byte of constant 
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Byte 3 



Third byte of constant 




Byte 4 



Fourth byte of constant 







This item causes the specified four-byte constant to be added 
to the loader's expression accumulator. Negative constants 
are represented in two's complement form. 

Add Absolute Section 



Byte 










Control byte 





1 


1 1 


R 


R 







1 



This item identifies the associated value (expression) as a 
positive absolute address. The address resolution code, RR, 
designates the desired resolution. 

Subtract Absolute Section 



Byte 












Control byte 





1 


1 1 





R 


R 







1 



This item identifies the associated value (expression) as a 
negative absolute address. The address resolution code, 
RR, designates the desired resolution. 

Add Value of Declaration 



Byte 










Control byte 








10 


R 


R 



Byte 1 


1 


2 3 4 5 


6 


7 


First byte of name number 





Byte 2 








7 


Second byte of name number 





If the module has fewer than 256 previously assigned name 
numbers, this byte is absent. 



This item causes the value of the specified declaration to be 
added to the loader's expression accumulator. The address 
resolution code, RR, designates the desired resolution, and 
the name number refers to a previously declared definition 
name that is to be associated with the first location of the 
allocated section. 

One such item must appear in each expression for a reloca- 
table address occurring within a control section, adding the 
value of the specified control section declaration (i.e., 
adding the byte address of the first location of the control 
section). 



Add Value of Forward Reference 



Byte 








Control byte 








1 1 R 


R 



Byte 1 


1 


2 3 4 5 6 


7 




First 


byte of forward reference number 








Byte 2 



Second byte of forward reference number 



7 

This item causes the value of the specified forward reference 
to be added to the loader's expression accumulator. The 
address resolution code, RR, designates the desired resolu- 
tion, and the designated forward reference must not have 
been defined previously. 



Subtract Value of Declaration 



Byte 










Control byte 








10 10 


R 


R 



Byte 1 


1 


2 3 4 5 


6 


7 


First byte of name number 





Byte 2 








7 






Second byte of name number 









This item causes the value of the specified declaration to 
be subtracted from the loader's expression accumulator. 
The address resolution code, RR, designates the desired 
resolution, and the name number refers to a previously de- 
clared definition name that is to be associated with the 
first location of the allocated section. 
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Subtract Value of Forward Reference 



Symbol Types 



Byte 






Control byte 





1 1 1 R 


R 



Byte 1 


12 3 4 5 6 


7 


First byte of forward reference number 





Byte 2 




7 


Second byte of forward reference number 





.0 7 

This item causes the value of the specified forward reference 
to be subtracted from the loader's expression accumulator. 
The address resolution code, RR, designates the desired reso- 
lution, and the designated forward reference must not have 
been defined previously. 

Change Expression Resolution 



Byt< 


20 














Control byte 










1 


1 





R 


R 







1 



This item causes the address resolution in the expression to 
be changed to that designated by RR. 

Expression End 

Byte 



Control byte 



















This item identifies the end of an expression (the value of 
which is contained in the loader's expression accumulator). 



FORMATION OF INTERNAL SYMBOL TABLES 

The three object code control bytes described below are re- 
quired to supply the information necessary in the formation 
of Internal Symbol Tables. 

In the following diagrams of load item formats, Type refers 
to the symbol types supplied by the object language and 
maintained in the symbol table. IR refers to the internal 
resolution code. Type and resolution are meaningful only 
when the value of a symbol is an address. In this case, it 
is highly likely that the processor knows the type of value 
that is in the associated memory location, and the type field 
identifies it. The resolution field indicates the resolution 
of the location counter at the time the symbol was defined. 
The following tables summarize the combinations of value 
and meaning. 



Type 


Meaning of 5-Bit Code 


00000 


Instruction 


00001 


Integer 


00010 


Short floating point 


00011 


Long floating point 


00110 


Hexadecimal (also for packed decimal) 


00111 


EBCDIC text (also for unpacked decimal) 


01001 


Integer array 


01010 


Short floating-point array 


01011 


Long floating-complex array 


01000 


Logical array 


10000 


Undefined symbol 





Internal Resolution 


IR 


Address Resolution 


000 


Byte 


001 


Halfword 


010 


Word 


011 


Doubleword 


100 


Constant 



Type Information for External Symbol 



Byte 










Control byte 








1 





1 



Byte 1 



Type field 



IR field 




Byte 2 



Name number 







Byte 3 (if required) 



Name number (continued) 



7 

This item provides type information for external symbols. 
The Type and IR fields are defined above. The name 
number field consists of one or two bytes (depending on the 
current declaration count) which specifies the declaration 
number of the external definition. 

Type and EBCDIC for Internal Symbol 
Byte 



Control byte 



1 
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Byte 1 






Type field IR field 





Byte 2 


4 5 


7 


Length of name (EBCDIC characters) 





Byte 3 




7 


First byte of name in EBCDIC 





Byte n 




7 


Last byte of name in EBCDIC 





Byte n 


+ 1,... 


7 


Expression defining value of internal symbol 





LOADING 



7 

This item supplies type and EBCDIQforan internal symbol . The 

1 oad items for Type and IR are as above . Length of name speci - 
fiesthelengthoftheEBCDICnameincharacters. Thename, in 
EBCDIC, is specified in the required number of bytes, followed 
by the expression defining the internal symbol. 

EBCDIC for an Undefined Symbol 



Byte 












Control byte 








1 





1 


1 




Byte 1 



Length of name (EBCDIC characters) 




Byte 2 



First byte of name in EBCDIC 




Byte n 



Last byte of name in EBCDIC 







Byte n + 1, n + 2 



Two bytes of symbol associated forward reference number 



Load Absolute 



ByteO 








Control byte 


1 


N N 


N 


N 


1 
Byte 1 


2 3 4 5 


6 


7 


First byte to be loaded 





Byte NNNN 






7 


Last byte to be loaded 





This item causes the next NNNN bytes to be loaded abso- 
lutely (NNNN is expressed in natural binary form, except 
that 0000 is interpreted as 16 rather than 0). The load loca- 
tion counter is advanced appropriately. 



Load Relocatable (Long Form) 
Byte 



Control byte 


1 


1 Q C 


R 


R 



Byte 1 


2 3 4 5 


6 


7 


First byte of name number 





Byte 2 






7 


Second byte of name number* 





7 

Thisitem causes a four-byte word (immediately following this 
load item) to be loaded, and relocates the address field 
according to the address resolution code, RR. Control bit 
C designates whether relocation is to be relative to a for- 
ward reference (C = 1) or relative to a declaration (C =0). 
Control bit Q designates whether a I -byte (Q = 1) or a 
2-byte (Q = 0) name number follows the control byte of 
this load item. 







This item is used to associate a symbol with a forward reference . 
The length of name and name in EBCDIC are the same as in the 
above item . The last two bytes specify the forward reference 
number with which the above symbol is to be associated. 



If the module has fewer than 256 previously assigned name 
numbers, this byte is absent. 
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If relocation is to be relative to a forward reference, the 
forward reference must not have been defined previously. 
When this load item is encountered by the loader, the load 
location counter can be aligned with a word boundary by 
loading the appropriate number of bytes containing all 
zeros (e.g., by means of a load absolute item). 



Load Relocatable (Short Form) 



Byte 1 



Byte 












Control byte 


1 C 


D 


D D 


D 


D 


D 







1 



This item causes a four-byte word (immediately following 
this load item) to be loaded, and relocates the address field 
(word resolution). Control bitC designates whether reloca- 
tion is to be relative to a forward reference (C= 1) or rela- 
tive to a declaration (C = 0). The binary number DDDDDD 
is the forward reference number or declaration number by 
which relocation is to be accomplished. 



If relocation is to be relative to a forward reference, the 
forward reference must not have been defined previously. 
When this load item is encountered by the loader, the load 
location counter must be on a word boundary (see "Load 
Relocatable (Long Form)", above). 



Repeat Load 



Byte 










Control byte 








11 


1 


1 



Byte 1 


1 


2 3 4 5 


6 


7 


First byte of repeat count 





Byte 2 




- 




7 


Second byte of repeat count 





This item causes the loader to repeat (i.e., perform) the 
subsequent load item a specified number of times. The 
repeat count must be greater than 0, and the load item to 
be repeated must follow the repeat load item immediately. 

Define Field 



Byte 








Control byte 








1 


1 1 



Field location constant, in bits (K) 




Byte 2 



Field length, in bits (L) 



7 

This item defines a value (expression) to be added to a field 
in previously loaded information. The field is of length L 
(1 < L < 255) and terminates in bit position T, where: 

T = current load bit position -256 +K. 



The field location constant, K, may have any value from 
1 to 255. The expression to be added to the specified 
field is the one immediately following byte 2 of this load 
item. 



MISCELLANEOUS LOAD ITEMS 



Padding 



Byte 












Control byte 





















Padding bytes are ignored by the loader. The object lan- 
guage allows padding as a convenience for processors. 

Module End 

Byte 



Control byte 











1 


1 


1 






Byte 1 


1 


2 


3 4 


5 


6 


7 


Severity level 











E 


E 


E 


E 



This item identifies the end of the object module. The 
value EEEE is the error severity level assigned to the 
module by the processor. 



OBJECT MODULE EXAMPLE 

The following example shows the correspondence between 
the statements of a Meta-Symbol source program and the 
string of object bytes output for that program by the assem- 
bler. The program, listed below, has no significance other 
than illustrating typical object code sequences. 
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Example 



1 










DEF 


AA,BB,CC 


CC IS UNDEFINED BUT CAUSES NO 
ERROR 


2 










REF 


RZ, RTN 


EXTERNAL REFERENCES DECLARED 


3 


00000 






ALPHA 


CSECT 




DEFINE CONTROL SECTION ALPHA 


4 


000C8 








ORG 


200 


DEFINE ORGIN 


5 


000C8 


22000000 


N 


AA 


LI,CNT 





DEFINES EXTERNAL AA; CNT IS A 
FWD REF 


6 


000C9 


32000000 


N 




LW,R 


RZ 


R IS A FORWARD REFERENCE; 


7 








* 




< 


RZ IS AN EXTERNAL REFERENCE, AS 


8 








* 






. DECLARED IN LINE 2 


9 


000CA 


50000000 


N 


RPT 


AH,R 


KON 1 


' DEFINES RPT; R AND KON ARE 


10 








* 




1 


k FORWARD REFERENCES 


11 


OOOCB 


69200000 


F 




BCS,2 


BB 


r BB IS AN EXTERNAL DEFINITION 


12 








* 






L USED AS A FORWARD REFERENCE 


13 


OOOCC 


20000001 


N 




AI,CNT 


1 


CNT IS A FORWARD REFERENCE 


14 


OOOCD 


680000CA 






B 


RPT 


RPT IS A BACKWARD REFERENCE 


15 


OOOCE 


68000000 


X 




B 


RTN 


RTN IS AN EXTERNAL REFERENCE 


16 


OOOCF 


0001 


A 


KON 


DATA, 2 


1 


DEFINES KON 


17 




00000003 




R 


EQU 


3 


DEFINES R 


18 




00000004 




CNT 


EQU 


4 


DEFINES CNT 


19 


OOODO 


224FFFFF 


A 


BB 


LI,CNT 


-1 


' DEFINES EXTERNAL BB THAT HAS 


20 








* 




< 


ALSO BEEN USED AS A FORWARD 


21 








* 






REFERENCE 


22 


000C8 








END 


AA 


END OF PROGRAM 



CONTROL BYTES (In Binary) 
Begin Record Record number: 



00111100 
00000000 
01100011 
01101100 



Record type: nor last, Mode binary, Format: object language. 
Sequence number 
Checksum: 99 
Record size: 108 



0302C1C1 (hexadecimal code comprising the load item) A 

00000011 Declare external definition name (2 bytes) Name: AA Declaration number: 1 



0302C2C2 
00000011 Declare external definition name (2 bytes) Name: BB Declaration number: 2 

0302C3C3 
00000011 Declare external definition name (2 bytes) Name: CC Declaration number: 3 ^ 

0502D9E9 
00000101 Declare primary reference name (2 bytes) Name RZ Declaration number: 4 



0503D9E3D5 
00000101 Declare primary reference name (3 bytes) Name: RTN Declaration number: 5 



Record control 
information not 
part of load item 



► Source Line 1 



► Source Line 2 
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Begin Record Record number: 



0A0 10 100000320200002 
00001010 "J Define external definition 

Number 1 
00000001 , Add constant: 800 X'320' 
00100000 Add value of declaration (byte resolution) 

Number 
00000010 J Expression end 

040100000320200002 
00000100 1 Origin 
00000001 Add constant: 800 X'320' 

00100000 - Add value of declaration (byte resolution) 

Number 
00000010 J Expression end 

4422000000 
01000100 Load absolute the following 4 bytes: X'22000000' 

07EB04260O0002 
00000111 ^ Define field 

Field location constant: 235 bits 

Field length: 4 bits 

Add the following expression to the above field: 
00100110 Add value of forward reference (word resolution) 

Number 
00000010 J Expression end 

8432000000 
10000100 Load relocatable (short form). Relocate address field (word resolution) 

Relative to declaration number 4 
The following 4 bytes: X' 32000000' 

07EB0426000602 
00000111 Define field 

Field location constant: 235 bits. 

Field length: 4 bits 

Add the following expression to the above field: 
00100110 Add value of forward reference (word resolution) 

Number 6 
00000010 Expression end 

CC50000000 
11001100 Load relocatable (short form). Relocate address field (word resolution) 

Relative to forward reference number 12 
The following 4 bytes: X' 50000000' 

07EB0426000602 
00000111 Define field 

Field location constant: 235 bits 

Field length: 4 bits 

Add the following expression to the above field: 
00100110 Add value of forward reference (word resolution) 

Number 6 
00000010 Expression end 



► Source Line 5 



Source Line 4 



* Source Line 5 



► Source Line 6 



Source Line 9 



No object code is generated for source lines 3 (define control section) or 4 (define origin) at the time they are encountered. 
The control section is declared at the end of the program after Symbol has determined the number of bytes the program requires. 
The origin definition is generated prior to the first instruction. 
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Begin Record Record number: 

D269200000 
11010010 Load relocatable (short form). Relocate address field (word resolution) 

Relative to forward reference number 18 
The following 4 bytes: X'69200000' 

4420000001 
01000100 Load absolute the following 4 bytes: X'20000001' 

07EB0426000002 
00000 111 Define field 

Field location constant: 235 bits 

Field length: 4 bits 

Add the following expression to the above field: 
00100110 Add value of forward reference (word resolution) 

Number 
00000010 Expression end 

80680000CA 
10000000 Load relocatable (short form). Relocate address field (word resolution) 

Relative to declaration number 
The following 4 bytes: X'680000CA' 

8568000000 
10000101 Load relocatable (short form). Relocate address field (word resolution) 

Relative to declaration number 5 
The following 4 bytes: X'68000000' 

08 
00001000 Define forward reference (continued in record 1) 



Source Line 1 1 



Source Line 13 



Source Line 14 



Source Line 15 



Source Line 16 



Begin Record Record number:! 



00011100 
00000001 
11101100 
01010001 



00000001 
00100000 

00000010 



01000010 



00001000 

00000001 
00000010 



00001000 

00000001 
00000010 



Record type: last, Mode: binary, Format: object language. 
Sequence number 1 
Checksum: 236 
Record size: 81 

00OC0100OO033C2OOO02 (continued from record 0) 

Number 12 

Add constant: 828 X'33C 

Add value of declaration (byte resolution) 

Number 

Expression end 

42001 

Load absolute the following 2 bytes: X'OOOT 

080006010000000302 
Define forward reference 
Number 6 

Add constant: 3 X'3 1 
Expression end 

080000010000000402 
Define forward reference 
Number 

Add constant: 4 X'4' 
Expression end 



Record Control 
Information 



Source Line 16 



Source Line 17 



" Source Line li 
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Begin Record Record number: 1 



0F00024100 
00001111 Repeat load 

Repeat count: 2 
01000001 Load absolute the following 1 bytes: X'00' 

0800 1 20 1 00000340200002 
00001000 Define forward reference 

Number 18 
00000001 Add constant: 832 X'340' 

Add value of declaration (byte resolution) 

Number 
00000010 Expression end 

0A020 1 00000340200002 

00001010 Define external definition 
Number 2 

00000001 Add constant: 832 X'340' 

00100000 Add value of declaration (byte resolution) 

Number 
00000010 Expression end 

44224FFFFF 
01000100 Load absolute the following 4 bytes: X'224FFFFF' 

0D0 100000320200002 
00001101 Define start 

00000001 Add constant: 800 X'320' 

00100000 Add value of declaration (byte resolution) 

Number 
00000010 Expression end 

0B000344 

00001011 Declare standard control section declaration number: 
Access code: Full access. Size 836 X'344 1 



Advance to Word 
Boundary 



Source Line 19 



Source Line 22 



0E00 
00001110 Module end 

Severity level: X'0' 



A table summarizing control byte codes for object language load items is given below. 



Object Code Control Byte 


Type of Load Item 











Padding 








1 


Add constant 





1 





Expression end 





1 


1 


Declare external definition name 


1 








Origin 


1 





1 


Declare primary reference name 


1 


1 





Declare secondary reference name 


1 


1 


1 


Define field 


10 








Define forward reference 


10 





1 


Declare dummy section 


10 


1 





Define external definition 
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Object Code 


Control 


Byte 






Type of Load Item 
















1 


1 


Declare standard control section 















1 








Declare nonstandard control section 















1 





1 


Define start 















1 


1 





Module end 















1 


1 


1 


Repeat load 
























Define forward reference and hold 





















1 


Provide type information for external symbol 


















1 





Provide type and EBCDIC for internal symbol 


















1 


1 


EBCDIC and forward reference number for undefined 


symbol 










1 


1 


1 





Declare page boundary control section 


















R 


R 


Add value of declaration 















1 


R 


R 


Add value of forward reference 












1 





R 


R 


Subtract value of declaration 












1 


1 


R 


R 


Subtract value of forward reference 









1 








R 


R 


Change expression resolution 









1 





] 


R 


R 


Add absolute section 









1 


1 





R 


R 


Subtract absolute section 




1 








N 


N 


N 


N 


Load absolute 




1 





1 


Q 


C 


R 


R 


Load relocatable (long form) 




1 c 


D 


D 


D 


D 


D 


D 


Load relocatable (short form) 
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APPENDIX G. XEROX STANDARD COMPRESSED LANGOAGE 



The Xerox standard compressed language is used to represent 
source EBCDIC information in a highly compressed form. 

Meta-Symbol (along with several of the utility programs) 
accepts this form as input or output, will accept updates to 
the compressed input and will regenerate source when re- 
quested. No information is destroyed in the compression or 
decompression. 

Records may not exceed 108 bytes in length. Compressed 
records are punched in the binary mode when represented 
on card media. Therefore, on cards, columns 73 through 
80 are not used and are available for comment or identifi- 
cation information. 

The first four bytes of each record are for checking purposes. 
They are as follows: 

Byte 1 Identification (00L1 1 000) L = 1 for each record 
except the last record, in which case L=0. 



Byte 2 Sequence number (0 to 255 and recycles). 

Byte 3 Checksum which is the least significant 8 bits 
of the sum of all bytes in the record except 
the checksum byte itself. Carries out of the 
most significant bit are ignored. If the 
checksum byte is all l's, do not checksum 
the record. 

Byte 4 Number of bytes comprising record including 
the checking bytes (< 108) 

The rest of the record consists of a string of 6-bit and 8-bit 
items. Any partial item at the end of a record is ignored. 

The following six-bit items (decimal number assigned) com- 
prise the string control: 



Item 


Function 


Item 


Function 





Ignore 


32 


O 


1 


Not currently assigned 


33 


P 


2 


End of line 


34 


Q 


3 


End of file 


35 


R 


4 


Use 8-bit character that follows 


36 


S 


5 


Usen+1 blanks (next 6-bit item is n) 


37 


T 


6 


Usen+65 blanks (next 6-bit item is n) 


38 


U 


7 


Blank 


39 


V 


8 





40 


W 


9 


1 


41 


X 


10 


2 


42 


Y 


11 


3 


43 


Z . 


12 


4 


44 


. 


13 


5 


45 


< 


14 


6 


46 


( 


15 


7 


47 


+ 


16 


8 


48 


1 


17 


9 


49 


& 


18 


A 


50 


$ 


19 


B 


51 


* 


20 


C 


52 


) 


21 


D 


53 


r 


22 


E 


54 


—, 


23 


F 


55 


- 


24 


G 


56 


/ 


25 


H 


57 


* 


26 


I 


58 


% 


27 


J 


59 


t__i 


28 


K 


60 


> 


29 


L 


61 


i 


30 


M 


62 


i 


31 


N 


63 


= 


Eight-bit characters are in uncompressed EBCDIC format (e 


• g., !@ # ?)- 
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APPENDIX H. XEROX STANDARD SYMBOLS, CODES AND CORRESPONDENCES 



XEROX STANDARD SYMBOLS AND CODES 

The symbols listed here include two types: graphic symbols 
and control characters. Graphic symbols are displayable 
and printable; control characters are not. Hybrids are SP 
(the symbol for a blank space), and DEL (the delete code) 
which is not considered a control command. 



Two types of code are also shown: (l)the 8-bit Xerox Stan- 
dard Computer Code, i.e., the Xerox Extended Binary- 
Coded- Interchange Code (EBCDIC); and (2) the 7-bit Amer- 
ican National Standard Code for information Interchange 
(ANSCII), i.e., the Xerox Standard Communication Code. 



XEROX STANDARD CHARACTER SETS 



1 . EBCDIC 



57-character set: uppercase letters, numerals, space, 
and &-/.<>() + I $ * :; , 

% # @ ' = 

63-character set: same as above plus 4 I ? 



2. ANSCII 

64-character set: uppercase letters, numerals, space, 
and ! " $%&'()*+,-•/ \ 
;:=<>? (a) _[] ^ # | -, 

95-character set: same as above plus lowercase letters 
and H ! ~ * 

CONTROL CODES 

In addition to the standard character sets listed above, the 
Xerox symbol repertoire includes 37 control codes and the 
hybrid code DEL (hybrid code SP is considered part of all 
character sets). These are listed in the table titled CP-V 
Symbol -Code Correspondences. 



SPECIAL CODE PROPERTIES 

The following two properties of all Xerox standard codes 
will be retained for future standard code extensions: 

1 . All control codes, and only the control codes, have 
their two high-order bits equal to "00". DEL is not 
considered a control code. 



89-character set: same as 63-character set plus lower- 
case letters 



2. No two graphic EBCDIC codes have their seven low- 
order bits equal. 



202 Appendix H 



Table H-l. CP-V 8-Bit Computer Codes (EBCDIC) 















Most Significant C 


)igits 














Hex 


adecimal 





1 


2 


3 


4 


5 


6 


7 


8 


9 


A 


B 


C 


D 


E 


F 




Binary 


0000 


0001 


0010 


0011 


0100 


0101 


0110 


0111 


1000 


1001 


1010 


1011 


1100 


1101 


1110 


mi 


h 

c 

D 
U 
u- 

*c 
lr> 

a 

0) 

_i 





0000 


NUL 


DLE 


LF 
only 


ESC 
F 


SP 


& 


- 


A 










SP 




- 





i 


0001 


SOH 


X-ON 


FS 


CAN 


7 




/ 


•• 


a 


i 




\' 


A 


J 




i 


2 


0010 


STX 


DC2 


GS 


ESC 
X 


1 




r 


■— 


b 


k 


s 


)' 


B 


K 


S 


2 


3 


0011 


ETX 


X-OFF 


RS 


ESC 
P 











c 


1 


t 


»' 


C 


L 


T 


3 


4 


0100 


EOT 


DC4 


US 


ESC 
U 


L 




1 


< 


d 


m 


u 


[' 


D 


M 


U 


4 


5 


0101 


HT 


LF 
NL 


EM 


ESC 
( 


« 


T 






e 


n 


V 


]' 


E 


N 


V 


5 


6 


0110 


ACK 


8 
SYN 


/ 


ESC 
) 




o 


<jj 


> 


f 


o 


w 




F 


O 


w 


6 


7 


0111 


BEL 


ETB 


A 


ESC 
T 






3 




g 


P 


X 




G 


P 


X 


7 


8 


1000 


EOM 
BS 


CAN 


- 


ESC 
S 


A 








h 


q 


Y 




H 


Q 


Y 


8 


9 


1001 


ENQ 


EM 


CR 
only 


ESC 
E 


I 






V 


i 


r 


z 




I 


R 


z 


9 


A 


1010 


NAK 


SUB 


EOT 


ESC 
C 


2 

i 


! 


^ 1 












7 






X 


B 


1011 


VT 


ESC 


BS 


ESC 
LF 




$ 


, 


# 
















T- 


C 


1100 


FF 


FS 


) 


X-ON 


< 


* 


% 


@ 








[ e 


... 








D 


1101 


CR 


GS 


HT 


X-OFF 


( 


) 




1 








]' 








— 


E 


1110 


SO 


RS 


LF 
only 


ESC 
R 


+ 


; 


> 


= 








Lost6 
Data 










F 


mi 


SI 


US 


SUB 


ESC 
CR 


i 2 


2 

— i 


? 


11 






8 I 


-, 6 








DEL 



Notes: 



1 



^v. 



3 6 4,7 5 

The characters^ \ \ } [] are ANSCII characters that do not appear in any of the Xerox EBCDIC-based 
character sets, though they are shown in the EBCDIC table. 

The characters fi I — i appear in the Xerox 63- and 89-character EBCDIC sets but not in either of the Xerox 
ANSCII-based sets. However, Xerox software translates the characters fL I - 1 into ANSCII characters as 
follows: 



EBCDIC 

i 



ANSCII 



N (6-0) 
1 (7-12) 
~ (7-14) 



The EBCDIC control codes in columns and 1 and their binary representation are exactly the same as those 
in the ANSCII table, except for two interchanges: LF/NL with NAK, and HT with ENQ. 

Characters enclosed in heavy lines are included only in the Xerox standard 63- and 89-character EBCDIC sets. 

These characters are included only in the Xerox standard 89-character EBCDIC set. 

The EBCDIC codes in column 3 are used by COC to perform special functions. The EBCDIC codes in 
column 2 and positions AF and BC through BF are used by COC for output only. 

APL characters are assigned EBCDIC values that fall within the shaded area of the CP-V code set. These 
assignments are for APL internal use and are only reflected in 2741 -APL translation tables. 

Placing a SYN code as the last position of a nontransparent message will prevent the transmission of the SYN 
and the normal message appendage of the CR/LF pair. This allows a user to continue writing more than one 
message on the same line without affecting the carrier position. The EBCDIC SYN code is translated to an 
idle (IL) on output to 2741 terminals. 
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Table H-2. CP-V 7-Bit Communication Codes (ANSCII) 



Notes: 













Most 


Significant C 


>igits 








Deci 
(rows 

1 


mat 

) (col's.)— 





1 


2 


3 


4 


5 


6 


7 




Binary 


xOOO 


xOOl 


xOlO 


xOll 


xlOO 


xlOl 


xllO 


xlll 


a> 
a 

c 
o 
u 

*4- 

"E 
.5? 

VI 

D 

a> 

_i 





0000 


NUL 


DLE 


SP 





@ 


P 


\ 


P 


1 


0001 


SOH 


DC1 


5 
! 


1 


A 


Q 


a 


q 


2 


0010 


STX 


DC2 


II 


2 


B 


R 


b 


r 


3 


0011 


ETX 


DC3 


I 


3 


C 


S 


c 


s 


4 


0100 


EOT 


DC4 


$ 


4 


D 


T 


d 


t 


5 


0101 


ENQ 


NAK 


% 


5 


E 


U 


e 


u 


6 


0110 


ACK 


SYN 


& 


6 


F 


V 


f 


V 


7 


0111 


BEL 


ETB 


1 


7 


G 


W 


9 


w 


8 


1000 


BS 


CAN 


( 


8 


H 


X 


h 


X 


9 


1001 


HT 


EM 


) 


9 


I 


Y 


i 


y 


10 


1010 


LF 
NL 


SUB 


* 




J 


Z 


J 


z 


11 


1011 


VT 


ESC 


+ 


; 


K 


V 


k 


\ 


12 


1100 


FF 


FS 


i 


< 


L 


\ 


1 


1 
1 


13 


1101 


CR 


GS 


- 


= 


M 


V 


m 


I 4 


14 


1101 


SO 


RS 


. 


> 


N 


4^ 5 


n 


4 


15 


mi 


SI 


US 


/ 


? 


O 


4 


o 


DEL 



1 Most significant bit, added for 8-bit format, is either or an even-parity bit for the remaining 7 bits. 

2 Columns 0-1 are control codes. 

3 Columns 2-5 correspond to the Xerox 64-character ANSCII set. 
Columns 2-7 correspond to the Xerox 95-character ANSCII set. 

4 On many current teletypes, the symbol 

^ is t (5-14) 
_ is -(5-15) 

~ is ESC or ALTMODE control (7-14) 
( is ESC or ALTMODE control (7-13) 

and none of the symbols appearing in columns 6-7 are provided. Except for the four symbol differences 
noted above, therefore, such teletypes provide all the characters in the Xerox 64-character ANSCII set. 
(The Xerox 7015 Remote Keyboard Printer provides the 64-character ANSCII set also, but prints^ as A. 
It also interprets the[ ] characters as I — \ .) 

5 On the Xerox 7670 Remote Batch Terminal, the symbol 

! is I (2-1) ] is ! (5-13) 

[ is / (5-11) '-is-' (5-14) 

and none of the symbols appearing in columns 6-7 are provided. Except for the four symbol differences noted 
above, therefore, this terminal provides all the characters in the Xerox 64-character ANSCII set. 



204 Appendix H 



Table H-3. CP-V Symbol-Code Correspondences 



EBCDIC* 


Symbol 


Card Code 


ANSCIl" 


Meaning 


Remarks 


Hex. 


Dec. 


00 





NUL 


12-0-9-8-1 


0-0 


null 


00 through IF are control codes. 


01 


1 


SOH 


12-9-1 


0-1 


start of header 


On 2741 terminals, SOH is PRE. 


02 


2 


STX 


12-9-2 


0-2 


start of text 


On 2741 terminals, STX is BY. 


03 


3 


ETX 


12-9-3 


0-3 


end of text 


On 2741 terminals, ETX is RES. 


04 


4 


EOT 


12-9-4 


0-4 


end of transmission 




05 


5 


HT 


12-9-5 


0-9 


horizontal tab 


00, 06, 07, 09-OB, and 0E-0F 


06 


6 


ACK 


12-9-6 


0-6 


acknowledge (positive) 


are idles for 2741 terminals. 


07 


7 


BEL 


12-9-7 


0-7 


bell 




08 


8 


BS or EOM 


12-9-8 


0-8 


backspace or end of message 


EOM is used only on Xerox Keyboard/ 


09 


9 


ENQ 


12-9-8-1 


0-5 


enquiry 


Printers Models 7012, 7020, 8091, 


0A 


10 


NAK 


12-9-8-2 


1-5 


negative acknowledge 


and 8092. 


0B 


11 


VT 


12-9-8-3 


0-11 


vertical tab 




OC 


12 


FF 


12-9-8-4 


0-12 


form feed 




0D 


13 


CR 


12-9-8-5 


0-13 


carriage return 


CR outputs CR and LF. 


0E 


14 


SO 


12-9-8-6 


0-14 


shift out 




OF 


15 


SI 


12-9-8-7 


0-15 


shift in 




10 


16 


DLE 


12-11-9-8-1 


1-0 


data link escape 




11 


17 


DC1 


11-9-1 


1-1 


device control 1 


On Teletype terminals, DC1 is X-ON. 


12 


18 


DC2 


11-9-2 


1-2 


device control 2 


On 2741 terminals, DC2 is PN. 


13 


19 


DC3 


11-9-3 


1-3 


device control 3 


DC3 is RS on 2741s and X-OFF on 


14 


20 


DC4 


11-9-4 


1-4 


device control 4 


Teletypes. 


15 


21 


LF or NL 


11-9-5 


0-10 


line feed or new line 


On 2741 terminals, DC4 is PF. 


16 


22 


SYN 


11-9-6 


1-6 


sync 


LF outputs CR and LF. 


17 


23 


ETB 


11-9-7 


1-7 


end of transmission block 


On 2741 terminals, ETB is EOB. 


18 


24 


CAN 


11-9-8 


1-8 


cancel 




19 


25 


EM 


11-9-8-1 


1-9 


end of medium 




1A 


26 


SUB 


11-9-8-2 


1-10 


substitute 


Replaces characters with parity error. 


IB 


27 


ESC 


11-9-8-3 


1-11 


escape 




1C 


28 


FS 


11-9-8-4 


1-12 


file separator 




ID 


29 


GS 


11-9-8-5 


1-13 


group separator 


10, 11, 16, 18, 19, and lB-lEare 


IE 


30 


RS 


11-9-8-6 


1-14 


record separator 


idles for 2741 terminals. 


IF 


31 


US 


11-9-8-7 


1-15 


unit separator 




20 


32 


LF only 


H-0-9-8-1 


1-5 


line feed only 


20 through 2F are used by COC for 


21 


33 


FS 


0-9-1 


1-12 




output only. These codes are 


22 


34 


GS 


0-9-2 


1-13 




duplicates of the label entries 


23 


35 


RS 


0-9-3 


1-14 




that caused activation. The 


24 


36 


US 


0-9-4 


1-15 




20-2F entries output a single code 


25 


37 


EM 


0-9-5 


1-9 




only and are not affected by any 


26 


38 


/ 


0-9-6 


2-15 




special COC functional processing. 


27 


39 


t 


0-9-7 


5-14 






28 


40 


= 


0-9-8 


3-13 






29 


41 


CR only 


0-9-8-1 


0-13 


carriage return only 




2A 


42 


EOT 


0-9-8-2 


0-4 






2B 


43 


BS 


0-9-8-3 


0-8 






2C 


44 


) 


0-9-8-4 


2-9 






2D 


45 


HT 


0-9-8-5 


0-9 


tab code only 




2E 


46 


LF only 


0-9-8-6 


1-5 


line feed only 




2F 


47 


SUB 


0-9-8-7 


1-10 






30 


48 


ESC F 


12-11-0-9-8-1 




end of file 


30 through 3F cause COC to perform 


31 


49 


CANCEL 


9-1 




delete all input and output 


special functions. 


32 


50 


ESC X 


9-2 




delete input line 




33 


51 


ESC P 


9-3 




toggle half-duplex paper tape made 




34 


52 


ESC U 


9-4 




toggle restrict upper case 




35 


53 


ESC ( 


9-5 




upper case shift 




36 


54 


ESC) 


9-6 




lower case shift 




37 


55 


ESCT 


9-7 




toggle tab simulation mode 




38 


56 


ESCS 


9-8 




toggle space insertion mode 




39 


57 


ESC E 


9-8-1 




toggle echo mode 




3A 


58 


ESCC 


9-8-2 




toggle tab relative mode 




3B 


59 


ESC LF 


9-8-3 




line continuation 


3B toggles the backspace edit mode 


3C 


60 


X-ON 


9-8-4 




start paper tape 


for 2741 terminals. 


3D 


61 


X-OFF 


9-8-5 




stop paper tape 




3E 


62 


ESC R 


9-8-6 




retype 




3F 


63 


ESCCR 


9-8-7 




line continuation 




Hexadecima 


and decimal 


notation. 








Decimal not 


ation (column- 


row). 
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Table H-3. CP-V Symbol-Code Correspondences (cont.) 



EBCDIC* 


Symbol 


Card Code 


ANSCII n 


Meaning 


Remarks 


Hex. 


Dec. 


40 


64 


SP 


blank 


2-0 


blank 




41 


65 




12-0-9-1 






41, 43, 46, and 47 are unassigned. 


42 


66 


1 


12-0-9-2 




decode 




43 


67 




12-0-9-3 








44 


68 


L 


12-0-9-4 




minimum 


42, 44, 45, 48, and 49 are APL 


45 


69 


€ 


12-0-9-5 




epsi Ion 


characters for 2741 APL use only. 


46 


70 




12-0-9-6 








47 


71 




12-0-9-7 








48 


72 


A 


12-0-9-8 




delta 




49 


73 


I 


12-8-1 




index 




4A 


74 


f£ or ' 


12-8-2 


6-0 


cent or accent grave 


Accent grave used for left single 


4B 


75 




12-8-3 


2-14 


period 


quote. On Model 7670, ' not 


4C 


76 


< 


12-8-4 


3-12 


less than 


available, and / = ANSCH 5-11. 


4D 


77 


( 


12-8-5 


2-8 


left parenthesis 


On 2741 APL, / is c (subset). 


4E 


78 


+ 


12-8-6 


2-11 


plus 




4F 


79 


1 or i 


12-8-7 


7-12 


vertical bar or broken bar 


On Model 7670, t not available, 
and l=ANSCII2-l. 


50 


80 


& 


12 


2-6 


ampersand 


On 2741 APL, & is fl (intersection). 


51 


81 




12-11-9-1 






51, 52, 54, 57, 58, and 59 are 


52 


82 




12-11-9-2 






unassigned. 


53 


83 


D 


12-11-9-3 




quad 


53, 55, and 56 are APL characters 


54 


84 




12-11-9-4 






for 2741 APL use only. 


55 


85 


T 


12-11-9-5 




encode 




56 


86 


O 


12-11-9-6 




circular 




57 


87 




12-11-9-7 








58 


88 




12-11-9-8 








59 


89 




11-8-1 








5A 


90 


! 


11-8-2 


2-1 


exclamation point 


On Model 7670, 1 is 1 . On 2741 


5B 


91 


$ 


11-8-3 


2-4 


dollars 


APL, ! is ° (degree). On 2741 


5C 


92 


* 


11-8-4 


2-10 


asterisk 


APL, $ is U (union). 


5D 


93 


) 


11-8-5 


2-9 


right parenthesis 




5E 


94 


; 


11-8-6 


3-11 


semicolon 




5F 


95 


~or— | 


11-8-7 


7-14 


tilde or logical not 


On Model 7670, ~ is not available, 
and— 1= ANSCH 5-14. 


60 


96 


_ 


11 


2-13 


minus, dash, h/phen 




61 


97 


/ 


0-1 


2-15 


slash 




62 


98 


r 


11-0-9-2 




maximum 


62, 64, 66, and 67 are APL characters 


63 


99 




11-0-9-3 






for 2741 APL use only. 


64 


100 


\ 


11-0-9-4 




down arrow 




65 


101 




11-f>-9-5 








66 


102 


tt) 


H-0-9-6 




omega 


63, 65, 68, and 69 are unassigned. 


67 


103 


3 


11-0-9-7 




superset 




68 


104 




11-0-9-8 








69 


105 




0-8-1 








6A 


106 


^>. 


12-11 


5-14 


circumflex 


On Model 7670 ~ is — i. On Model 


6B 


107 


1 


0-8-3 


2-12 


comma 


7015^ is A (caret). On 2741 APL, 


6C 


108 


% 


0-8-4 


2-5 


percent 


'"Ms t . On 2741 APL, % is P. 


6D 


109 


- 


0-8-5 


5-15 


underline 


Underline is sometimes called "break 


6E 


110 


> 


0-8-6 


3-14 


greater than 


character"; may be printed along 


6F 


111 


? 


0-8-7 


3-15 


question mark 


bottom of character line. 


70 


112 


A 


12-11-0 




APL 


70-72, 74, 76, and 79 are APL 


71 


113 




12-11-0-9-1 




APL quote mark 


characters for 2741 APL use only. 


72 


114 


— 


12-11-0-9-2 




overscore 




73 


115 




12-11-0-9-3 








74 


116 


< 


12-11-0-9-4 




less than or equal 


73, 75, 77, and 78 are unassigned. 


75 


117 




12-11-0-9-5 








76 


118 


> 


12-11-0-9-6 




greater than or equal 




77 


119 




12-11-0-9-7 








78 


120 




12-11-0-9-8 








79 


121 


V 


8-1 




down delta 




7A 


122 




8-2 


3-10 


colon 




7B 


123 


# 


8-3 


2-3 


number 




7C 


124 


@ 


8-4 


4-0 


at 




7D 


125 


' 


8-5 


2-7 


apostrophe (right single quote) 




7E 


126 


= 


8-6 


3-13 


equals 




7F 


127 


" 


8-7 


2-2 


quotation mark 




Vlex 


adecima 


and dec! ma 


notation. 








tt 
Dec 


imal not< 


jtion (column 


-row). 
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Fable H-3. CP-V Symbol-Code Correspondences (conr.) 



EBCDIC* 


Symbol 


Card Code 


ANSCll" 


Meaning 


Remarks 


Hex. 


Dec. 


80 


128 




12-0-8-1 






80 is unassfgned. 


81 


129 


a 


12-0-1 


6-1 




81-89, 91-99, A2-A9 comprise the 


82 


130 


b 


12-0-2 


6-2 




lowercase alphabet. Available 


83 


131 


c 


12-0-3 


6-3 




only in Xerox standard 89- and 95- 


84 


132 


d 


12-0-4 


6-4 




character sets. 


85 


133 


e 


12-0-5 


6-5 






86 


134 


f 


12-0-6 


6-6 






.87 


135 


g 


12-0-7 


6-7 






88 


136 


h 


12-0-8 


6-8 






89 


137 


i 


12-0-9 


6-9 






8A 


138 




12-0-8-2 






8A through 90 are unassigned. 


8B 


139 




12-0-8-3 








8C 


140 




12-0-8-4 








8D 


141 




12-0-8-5 








8E 


142 




12-0-8-6 








8F 


143 




12-0-8-7 








90 


144 




12-11-8-1 








91 


145 


j 


12-11-1 


6-10 






92 


146 


k 


12-11-2 


6-11 






93 


147 


1 


12-11-3 


6-12 






94 


148 


m 


12-11-4 


6-13 






95 


149 


n 


12-11-5 


6-14 






96 


150 


o 


12-11-6 


6-15 






97 


151 


P 


12-11-7 


7-0 






98 


152 


q 


12-11-8 


7-1 






99 


153 


r 


12-11-9 


7-2 






9A 


154 




12-11-8-2 






9A through Al are unassigned. 


9B 


155 




12-11-8-3 








9C 


156 




12-11-8-4 








9D 


157 




12-11-8-5 








9E 


158 




12-11-8-6 








9F 


159 




12-11-8-7 








AO 


160 




11-0-8-1 








Al 


161 




11-0-1 








A2 


162 


s 


11-0-2 


7-3 






A3 


163 


t 


11-0-3 


7-4 






A4 


164 


u 


11-0-4 


7-5 






A5 


165 


V 


11-0-5 


7-6 






A6 


166 


w 


11-0-6 


7-7 






A7 


167 


X 


11-0-7 


7-8 






A8 


168 


y 


11-0-8 


7-9 






A9 


169 


z 


11-0-9 


7-10 






AA 


170 




11-0-8-2 






AA through AE are unassigned. 


AB 


171 




11-0-8-3 








AC 


172 




11-0-8-4 








AD 


173 




11-0-8-5 








AE 


174 




11-0-8-6 








AF 


175 


1 


11-0-8-7 




logical and 


AF is used by COC for output of 
an ANSCII 7-12 code only. 


BO 


176 


\ 
{ 

1 


12-11-0-8-1 








Bl 


177 


12-11-0-1 


5-12 


backslash 




B2 


178 


12-11-0-2 


7-11 


left brace 


On 2741 terminals, { is output as (. 


B3 


179 


} 


12-11-0-3 


7-13 


right brace 


On 2741 terminals, } is output as ). 


B4 


180 


[ 


12-11-0-4 


5-11 


left bracket 


On Model 7670, [ is {. On Model 


B5 


181 


] 


12-11-0-5 


5-13 


right bracket 


7015, [is 1. 


B6 


182 




12-11-0-6 






On Model 7670, ] is !. On Model 


B7 


183 




12-11-0-7 






7015, ] is-i. 


B8 


184 




12-11-0-8 






B0 and B6 through BB are unassigned. 


B9 


185 




12-11-0-9 








BA 


186 




12-11-0-8-2 








BB 


187 




12-11-0-8-3 








BC 


188 


[ 


12-11-0-8-4 




left bracket 


BC, BD, and BF are used by COC for 


BD 


189 


] 


12-11-0-8-5 




right bracket 


output of ANSCII 5-1 1, 5-13, and 


BE 


190 


lost- data 


12-11-0-8-5 




lost data 


7-14, respectively. 


BF 


191 


— 1 


12-11-0-8-7 




logical not 


On 2741 Selectric and EBCD Standard 
Keyboards, [ is output as ( and ] 
is output as ). 


Hexadecimal 


and decimal 


notation. 








Decimal nota 


■ion (column- 


-row). 
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Table H-3. CP-V Symbol-Code Correspondences (cont.) 



EBCDIC* 


Symbol 


Card Code 


ANSCH n 


Meaning 


Remarks 


Hex. 


Dec. 


CO 


192 


SP 


12-0 


2-0 


blank 


Output only. 


CI 


193 


A 


12-1 


4-1 




C1-C9, D1-D9, E2-E9 comprise the 


C2 


194 


B 


12-2 


4-2 




uppercase alphabet. 


C3 


195 


C 


12-3 


4-3 






C4 


196 


D 


12-4 


4-4 






C5 


197 


E 


12-5 


4-5 






C6 


198 


F 


12-6 


4-6 






C7 


199 


G 


12-7 


4-7 






C8 


200 


H 


12-8 


4-8 






C9 


201 


I 


12-9 


4-9 






CA 


202 




12-0-9-8-2 






CA through CF are unassigned. 


CB 


203 




12-0-9-8-3 








CC 


204 




12-0-9-8-4 








CD 


205 




12-0-9-8-5 








CE 


206 




12-0-9-8-6 








CF 


207 




12-0-9-8-7 








DO 


208 




11-0 






DO is unassigned. 


Dl 


209 


J 


11-1 


4-10 






D2 


210 


K 


11-2 


4-11 






D3 


211 


L 


11-3 


4-12 






D4 


212 


M 


11-4 


4-13 






D5 


213 


N 


11-5 


4-14 






D6 


214 


O 


11-6 


4-15 






D7 


215 


P 


11-7 


5-0 






D8 


216 


Q 


11-8 


5-1 






D9 


217 


R 


11-9 


5-2 






DA 


218 




12-11-9-8-2 






DA through DF are unassigned. 


DB 


219 




12-11-9-8-3 








DC 


220 




12-11-9-8-4 








DD 


221 




12-11-9-8-5 








DE 


222 




12-11-9-8-6 








DF 


223 




12-11-9-8-7 








EO 


224 


_ 


0-8-2 


2-13 


minus 


Output only. El is unassigned. 


El 


225 




11-0-9-1 








E2 


226 


S 


0-2 


5-3 






E3 


227 


T 


0-3 


5-4 






E4 


228 


U 


0-4 


5-5 






E5 


229 


V 


0-5 


5h5 






E6 


230 


W 


0-6 


5-7 






E7 


231 


X 


0-7 


5-8 






E8 


232 


Y 


0-8 


5-9 






E9 


233 


Z 


0-9 


5-10 






EA 


234 




11-0-9-8-2 






EA through EF are unassigned. 


EB 


235 




11-0-9-8-3 








EC 


236 




11-0-9-8-4 








ED 


237 




11-0-9-8-5 








EE 


238 




11-0-9-8-6 








EF 


239 




11-0-9-8-7 








FO 


240 








3-0 






Fl 


241 


1 


1 


3-1 






F2 


242 


2 


2 


3-2 






F3 


243 


3 


3 


3-3 






F4 


244 


4 


4 


3-4 






F5 


245 


5 


5 


3-5 






F6 


246 


6 


6 


3-6 






F7 


247 


7 


7 


3-7 






F8 


248 


8 


8 


3-8 






F9 


249 


9 


9 


3-9 






FA 


250 


X 


12-11-0-9-8-2 




multiply 


FA through FF are APL characters 


FB 


251 


V 


12-11-0-9-8-3 




divide 


for 2741 APL use only. 


FC 


252 


— 


12-11-0-9-8-4 




right arrow 




FD 


253 


— 


12-11-0-9-8-5 




left arrow 




FE 


254 




12-11-0-9-8-6 






FE is not assigned. 


FF 


255 


DEL 


12-11-0-9-8-7 




delete 


Special —neither graphic nor 
control symbol. 


Hexadecimal and decimal 


notation. 




Decimal notation (column 


-row). 


—————— ^ _ 
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Table H-4. ANSCII Control -Character Translation Table 



Input 


Output 




TTY 




Prog. Receives 






Transmitted 


ANSCII 


Key 


Echoed 


(EBCDIC) 


Process 


EBCDIC 


(ANSCII) 


NUL (00) 


p cs 


None 


None 


None 


NUL (00) 


Nothing (end of 
output message) 


SOH (01)* 


A C 


SOH 


SOH 


None 


SOH (01) 


SOH 


STX (02)* 


B C 


STX 


STX 


None 


STX (02) 


STX 


ETX (03/ 


c c 


ETX 


ETX 


None 


ETX (03) 


ETX 


EOT (04)* 


D C 


EOT 


EOT 


Input Complete. 


EOT (04) 


EOT 


ENQ (05)* 


E c 


ENQ 


ENQ (09) 


None 


HT (05) 


Space (s) if tab 
simulation on, or 
HT(09)if not. 


ACK (06)* 


F C 


ACK 


ACK 


None 


ACK (06) 


ACK 


BEL (07) 


G C 


BEL 


BEL 


None 


BEL (07) 


BEL 


BS (08) 


H c 


BS 


BS 


None 


BS (08) 


BS 


HT (09) 


I c 


Space to tab stop 
if tab simulation 
on, or 1 space if 
not. 


Spaces to tab stop, 
or one space, or tab 
(05) depending on 
space insertion mode. 


None 


ENQ (09) 


ENQ (05) 


LF/NL (0A) 


NL 


CR and LF 


LF (15) 


Input Complete. 


NAK (0A) 


NAK (15) 


VT (0B) 


K c 


VT 


VT 


None 


VT (0B) 


VT 


FF (0C) 


L c 


None 


FF 


Page Header and 
Input Complete. 


FF (0C) 


Page Header 


CR (0D) 


CR 


CR and LF 


CR (0D) 


Input Complete. 


CR (0D) 


CR and LF (0A) 


SO (0E) 


N C 


SO 


SO 


None 


SO (0E) 


SO 


SI (OF) 


o c 


SI 


SI 


None 


SI (OF) 


SI 


DLE (10)* 


P c 


DLE 


DLE 


None 


DLE (10) 


DLE 


DC1 (11) 


Q c 


DC1 


None 


Paper Tape On. 


DC1 (11) 


DC1 


DC2 (12) 


R c 


DC2 


DC2 


None 


DC2 (12) 


DC2 


DC3 (13) 


S c 


DC3 


None 


Paper Tape Off. 


DC3 (13) 


DC3 


DC4 (14)* 


T c 


DC4 


DC4 


None 


DC4 (14) 


DC4 


NAK (15)* 


u c 


NAK 


NAK (0A) 


None 


LF/NL (15) 


CR and LF (0A) 


These charact 


ers are co 


mmunication control 


characters reserved for 


use by hardware. 


Any other use < 


af them risks in- 


compatibility ^ 


with future 


} hardware developm 


ents and is done so by 1 


[■he user at his own 


risk. 
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Table H-4. ANSCII Control-Character Translation Table 


(cont.) 




Input 


Output 


ANSCII 


TTY 
Key 


Echoed 


Prog. Receives 
(EBCDIC) 


Process 


EBCDIC 


Transmitted 
(ANSCII) 


SYN (16) 1 " 


v c 


SYN 


SYN 


None 


SYN f (16) 


SYN (not trans- 
mitted for last 
character in 
user's buffer). 


ETB (17)* 


w c 


ETB 


ETB 


None 


ETB (17) 


ETB 


CAN (18) 


x c 


Back-arrow 
and CR/LF 


None 


Cancel input 
or output 
message. 


CAN (18) 


CAN 


EM (19) 


Y° 


Back-arrow 
and CR/LF 


None 


Monitor Escape/ 
Control to TEL 


EM (19) 


EM 


SUB (1A) 


Z c 


SUB 


SUB 


Input Complete 


SUB (1A) 


#(A3) 


ESC (IB) 


K cs 
ESC 
PREFIX 


None 


None 


Initiate escape 
sequence mode. 


ESC (IB) 


ESC 


FS (1C) 


L CS 


FS 


FS 


Input Complete 


FS (1C) 


FS 


GS (ID) 


M CS 


GS 


GS 


Input Complete 


GS (ID) 


GS 


RS (IE) 


N CS 


RS 


RS 


Input Complete 


RS (IE) 


RS 


US (IF) 


o cs 


US 


US 


Input Complete 


US (IF) 


US 


l(7D) 


ALT- 
MODE 


| or None 


} or None 


} if model 37; as 
ESC if model 33, 
35, or 7015. 


((B3) 


l(7D) 


~(7E) 


ESC 
(7015) 


~or None 


~or None 


~if model 37; as 
ESC if model 33, 
35, or 7015 


~-(5F) 


~(7E) 


DEL (7F) 


Rubout 


\ 


None 


Rubout last 
character. 


DEL (FF) 


None 


All ANSCII upper and lower case alphabetics are translated on input into the 
corresponding EBCDIC graphics as shown in Tables C-1 and C-2. All special 
graphics map as shown, allowing for Table C-1, Note 2, and the exceptions 
above for model 33 and 35. Lower case alphabetics map into corresponding 
EBCDIC upper case if the ESC U mode is set. Upper case alphabetics map 
into corresponding EBCDIC lower case if ESC) is set. 


Alphabetic and 
lation is also as 
and C-2; for Mo 
7015 terminals, 
alphabetics are 
lated to upper c 


symbol output trans- 
shown in Tables C-1 
dels 33 and 35, and 
however, lowercase 
automatical ly trans- 
ase. 


These characters are communication control characters reserved for use by hardware, 
compatibility with future hardware developments and is done so by the user at his own 


Any other use o 
risk. 


f them risks in- 
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Table H-4. Substitutions for Nonexistent Characters on 2741 Keyboards 



EBCDIC 


APL 


Selectric 


EBCD 


Character 


Keyboard 


Keyboard 


Keyboard 


> 


> 


, (upper case) 


> 


< 


< 


. (upper case) 


< 


1 


t 
1 


4 

(degree) 


4 
1 


-» 


- 


± 


- 


# 


t 


# 


# 


% 


P 


% 


% 


4 


C 


4 


4 


@ 


a 


@ 


@ 


■I 


V 


ii 


■I 


! 


o 


i 


j 


& 


n 


& 


& 


$ 


u 


$ 


$ 
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* command, ANLZ, 43 
? command, DRSP, 104 
I command, ANLZ, 43 
2741 terminal, 

substitutions for nonexistent characters, 211 



APL, 7 

application processors, 10 
armed interrupt, 119 
automatic recovery, 22 



A Programming Language 7 
active interrupt, 119 
ALL command, ANLZ, 40 
Analyze (see ANLZ) 
ANLZ, 39,10,22 
ANLZ, batch mode, 39 
ANLZ, command summary, 55,54 
ANLZ, commands, 39 

*, 43 

t, 43 

ALL, 40 

BF, 44 

CLOSE, 45 

COMPARE, 43 

DELTA, 44 

DISPLAY, 40 

DUMP, 45 

END, 45 

HELP, 45 

INPUT, 40 

IS, 45 

LINE FEED, 43 

loc, 40 

loc=value, 43 

loci, loc2, 43 

LP, 44 

MAP, 43 

MONITOR, 43 

NODELTA, 44 

PRINT, 44 

ROWS, 44 

RUN, 40 

SEARCH, 44 

SMASK, 44 

SYMBOLS, 45 

SYMBOL/, 45 

UC, 44 

UNMAP, 43 
ANLZ, ghost mode, 39 
ANLZ, messages, 54 
ANLZ, on-line mode, 39 
ANLZ, output, 45 
ANS COBOL, 7 
ANS labeled tape, xi 
ANSCII, 204,202,209 



B 



BASIC, 6 

Batch (processor), 10 
batch job, xi 
batch processing, 1 
BF command, ANLZ, 44 
binary input, xi 
booting, 23,35 
from disk, 37 
bootstrap I/O error recovery, 38 
bootstrap operations (see booting) 



CCI, 93,4 

character sets, 202 

CIRC, 11 

cleared interrupt, 119 

CLIS command, PPS, 64 

CLOSE command, ANLZ, 45 

cluster/unit matrix, 148 

COBOL, 7 

COBOL On-Line Debugger, 9 

codes and correspondences, 205 

command processor programming, 95 

command processors, 3 

command summaries, 

ANLZ, 55,54 

DRSP, 107,104 

ELLA, 85,84 
command syntax notation, x 
COMPARE command, ANLZ, 43 
compressed language, 295 
concatenation, xi 

conditional patch control commands, 33 
conflicting reference, xi 
Control (processor), 4 
control message, xi 
cooperative, xi 
CP-V operating system, 3 
crash analysis (see ANLZ) 
control codes, 267 
Control Command Interpreter, 93,4 
control commands, xi 
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Data Control Block (see DCB) 
DCB, 90, xi 

diagnostic, 1 14, 109 
DDCB, 114,109 
DEFCOM, 9 
DELETE command, 

DRSP, 103 

GENMD, 33 
Delta, 8 

DELTA command, ANLZ, 44 
Delta format patches, 23 
DEV command, ELLA, 78 
DEVDMP, 5 

device designation codes, 148 
device names, 148 
Device Save/Restore processor, 5 
device type codes, 148 
diagnostic DCB, 114,109 

diagnostics (see on-line peripheral diagnostic facilities) 
disabled interrupt, 119 
disarmed interrupt, 1 19 
DISP command, ELLA, 75 
DISPL command, ELLA, 81 
DISPLAY command, 

ANLZ, 40 

PPS, 138 
DRSP, 102,10 

DRSP, command summary, 107, 104 
DRSP, commands, 

?, 104 

DELETE, 103 

END, 104 

ENTER, 102 

LIST, 103 

LISTALL, 103 

REPLACE, 103 
DRSP, error messages, 104 
DRSP, limitations and restrictions, 104 
DUMP command, ANLZ, 45 

Dynamic Replacement of Shared Processors (see DRSP) 
DYNRESDF command, PPS, 139 



E 



EASY, 4 

EBCDIC, 203,202 

Edit (processor), 9 

EDMS, 11 

ELLA, 61,10,21 

ELLA, command summary, 85,84 

ELLA commands, 

CLIS, 64 

DEV, 78 

DISP, 75 

DSPL, 81 



END, 76 

MOD, 78 

RSET, 76 

SET, 61 

SLIS, 71 

SUM, 75 

TIME, 77 

TYPE, 78 
ELLA, error log entry headings, 66 
ELLA, error log entry types, 71 
ELLA, input/output assignments, 61 
ELLA, input/output characteristics, 63 
ELLA, interrupting execution, 64 
ELLA, messages, 84 
ELLA, predefined tasks, 81 
ELLA, starting execution, 61 
enabled interrupt, 119 
END command, 

ANLZ, 45 

DRSP, 104 

ELLA, 76 

PPS, 140 
:END command (boot-time), 28 
ENTER command, DRSP, 102 
ERRrFIL, 61,21 
ERRFILE file, 168,61 
ERRFILE file formats, 168 

bad granule release, 178 

configuration record, 177 

device error, 173 

duplicate entries, 177 

enqueue table overflow, 184 

errlog record length error, 171 

file inconsistency error, 175 

hardware errors, 174 

I/O activity count, 182 

illegal entry type, 172 

incorrect time, 172 

instruction exception, 176 

lost entry indicator, 177 

memory fault interrupt, 172 

memory parity secondary record, 183 

MFI primary record, 183 

operator message, 182 

partitioned resource, 184 

PFI primary record, 182 

power on, 177 

processor fault interrupt, 172 

read error, 171 

remote processing error, 178 

returned resource, 184 

secondary record for poll information, 183 

secondary records for device errors, disk pack, 
RAD, and tape, 174 

Sigma 6/7 memory parity secondary record, 183 

SIO failure, 172 

software-detected symbiont inconsistencies, 176 

system identification, 177 

system startup, 175 

time out, 173 
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time stamp, 178 

unexpected interrupt, 173 

watchdog timer, 175 

Xerox 560 memory parity secondary record, 183 
ERRMSG file, 59 

error detection and recovery, 20,21 
error log display, 174 
error log file (see ERRFILE) 
Error Log Listing program (see ELLA) 
error log, reading, 189 
error log, writing, 189 
error message file, 59 
error messages (see messages) 
error record terminology, 168 
execution control processors, 8 
Extended FORTRAN IV, 5 
extension of output files, 95, xi 
external reference, xi 



F 



FDP, 9 

fid, 91 

File Restore processor, 5 

fi les, 

extension, 95, xi 

identification, 91 

shared, 1 16 
FILL (processor), 4 
Fix, 4 

fixed monitor locations, 88 
FLAG, 7 
FORTRAN, 5 

FORTRAN Debug Package, 9 
FORTRAN Load and Go, 7 
FPT, xi 

FREE command, PPS, 138 
FRES, 5 
FSAVE, 5 
function parameter table, xi 



GENMD command, GENMD, 33 

GET command, PPS, 138 

ghost job, xi 

ghost job, initiating, 190 

global symbol, xi 

:GO command (boot-time), 26 

GO file, xi 

GPDS, 11 

Granule Accounting Cleanup processor, 5 

granule, xi 



H 



hardware-error diagnostic CALs, 85 

initiate ghost job, 86 

read error log, 86 

write error log, 86 
HELP command, 

ANLZ, 45 

ERR: LIST, 175 



I 



I/O scheduling, 17 

ICB, 119 

initialization and start-up routines, 264 

INPUT command, ANLZ, 40 

interrupt connection and control services, real-time, 119 

interrupt control block, 119 

interrupt label, 119 

IOP designation codes, 148 

IS command, ANLZ, 45 



J 



GAC, 5 

rGENDCB command, 32 
General Purpose Discrete Simulator, 11 
GENMD, 
commands, 
DELETE, 33 
GENMD, 33 
LIST, 33 
error messages, 34, 33 
patches, 33 



JIT, 88, xi 

job information table, 88, xi 

job step, xi 



key, xi 
key-in, xi 
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L 



Label, 5 

language processors, 5,xi 

libraries, 1 18 

public, 98 
library load module, xi 
LINE FEED command, ANLZ, 43 
Link (processor), 8 
linking loader, xi 

(see Link processor) 
LIST command, 

DRSP, 103 

GENMD, 33 
LISTALL command, DRSP, 103 
Load (processor), 8 
load map, xi 
load module, xi 
loc command, ANLZ, 40 
loc= value command, ANLZ, 43 
loci, loc2 command, ANLZ, 43 
log-on connection, 87 
logical device, xi 
logical device stream, xi 
LOGON/LOGOFF, 3 
LP command, ANLZ, 44 



M:QUE, 135 
M:QUEUE, 141 
M:RDG, 131 
M:RUE, 131 
M:SIO, 112 
MrSLAVE, 129 
MrSTARTIO, 127 
M:STOPIO, 125 
Manage, 8 

MAP command, ANLZ, 43 
master system tape, 23, 24 
memory control, 89 
memory layout, 19 
memory management, 13 
messages, 

ANLZ, 54 

ELLA, 84 

GENMD, 263 

on-line peripheral diagnostics, 114 

PASSO, 38 
Meta-Symbol, 6 
MOD command, ELLA, 78 
monitor, 12,xii 

MONITOR command, ANLZ, 43 
monitor DEFs (for real-time), 140 
monitor dump analysis program (see ANLZ) 



M 

MrBLIST, 111 
M:CHKINT, 132 
MrCLOCK, 125 
MrCOC, 136 
MrCONNECT, 120 
M:DCLOSE, 111 
M:DDCB, 109 
M:DISCONNECT, 121 
M:DMOD#, 113 
MiDOPEN, 110 
M:EXCP, 133 
M:EXU, 129 
M:FPP, 130 
M:GDG, 131 
MrGJOB, 130 
M:GJOBCON, 120 
M:GPP, 130 
M:HOLD, 124 
MrlNHIBIT, 122 
M:INTCON, 122 
M:INTRTN, 123 
M-.INTSTAT, 124 
M:IOEX, 127 
M:LOCK, 113 
M:MAP, 113,130 
M:M ASTER, 129 
MrNEWQ, 133 
M:QFI, 123 



N 



NODELTA command, ANLZ, 44 



object language, xii 

object module, xii 

on-line job, xii 

on-line peripheral diagnostic facilities, 108,22 

access device directly for diagnostics, 190 

abnormal codes and messages, 114 

DDCB, 114,109 

M:BLIST, 111 

M.-DCLOSE, 111 

M:DDCB, 109 

M:DMOD#, 113 

MrDOPEN, 110 

M:LOCK, 113 

M:MAP, 113 

M:SIO, 112 

PSECT directive, 108 

restrictions, 108 
operational label, 147, xii 
overlay loader, xii 

(see Load processor) 
overlay program, xii 
overlay restrictions, shared processors, 89 
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page allocation for real-time, 136 
:PART command, 

boot-time, 26 
partitioning resources, 26 
PASSO, 38 

PASSO, error messages, 38 
patch, xii 

patch control commands, conditional, 33 
patch deck comment cards, 34 
patch deck structure, 23 
patch deck symbol table, 25 
patch file creation, 35 
patches, Delta format, 23 
patching operations, 23 
PCL, 9 

Peripheral Conversion Language, 9 
peripheral device (see device) 
peripheral diagnostic facilities (see on-line peripheral 

diagnostic facilities) 
physical device, xii 

(see device) 
physical page allocation for real-time, 136 
Physical Page Stealer (see PPS) 
PPS, 137 
PPS commands, 

DISPLAY, 138 

DYNRESDF, 139 

END, 140 

FREE, 138 

GET, 138 

RESDF, 139 
preventive maintenance, 199 
PRINT command, ANLZ, 44 
procedures, 199, 195 

MrBLIST, 111 

MrCHKINT, 132 

M:CLOCK, 125 

M:COC, 136 

M:CONNECT, 120 

M:DCLOSE, 111 

M:DDCB, 109 

M:DISCONNECT, 121 

M:DMOD # , 113 

M:DOPEN, 110 

M:EXCP, 133 

M.-EXU, 129 

M:FPP, 130 

M:GDG, 131 

M:GJOB, 130 

M:GJOBCON, 120 

M:GPP, 130 

M:HOLD, 124 

M:INHIBIT, 122 

MrlNTCON, 122 

MrlNTRTN, 123 

MrlNTSTAT, 124 

M:IOEX, 127 

M:LOCK, 113 



M.-MAP, 113,130 

M.-MASTER, 129 

MrNEWQ, 133 

M:QFI, 123 

M:QUE, 135 

M:QUEUE, 141 

M:RDG, 131 

M:RUE, 131 

M:SIO, 112 

M:SLAVE, 129 

M:STARTIO, 127 

M:STOPIO, 125 
processor management, 18 
processors, 

application, 10 

command, 3 

execution control, 8 

language, 5 

service, 9 

shared processor facilities, 87 

system management, 4 

user, 87, 13 
program product, xii 
prompt character, xii 
protective mode, xii 
PSECT directive, 108, 130 
public library, 98, xii 
public programs, 87 



RATES, 4 

read error log, 189 

real-time facilities, 119 

clock service, 125 

device preemption services, 125 

direct I/O services, 127 

dynamic physical page allocation, 136 

interrupt connection and control services, 119 

lock in core service, 124 

miscellaneous services, 130 
reconfiguration and partitioning commands, 26 

:END, 28 

:GO, 26 

:PART, 28 

.•REMOVE, 27 

:SAVE, 27 

:TYPE, 27 
reconfiguration and partitioning command summary, 28 
reconfiguration and partitioning messages, 30,28 
recovery, 20,21 
reentrant, xii 
relative allocation, xii 
relocatable object module (ROM), xii 
remote diagnostic assistance, 165,22 
:REMOVE command (boot-time), 27 
REPLACE command, DRSP, 103 
RESDF command, PPS, 139 
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RESDF memory CAL, 140 
resident program, xii 
response time, xii 
ROWS command, ANLZ, 44 
RSET command, ELLA, 76 
RUN command, ANLZ, 40 



:SAVE command (boot-time), 27 

scheduler, xii 

scheduler inputs, 14 

scheduler operation, 15 

scheduler output, 15 

scheduler status queues, 16 

scheduling, 13 

screech codes, 149 

SEARCH command, ANLZ, 44 

secondary storage, xii 

semi-protective mode, xii 

service processors, 9 

SET command, ELLA, 61 

shared file use, 95 

shared processor, xii 

shared processor facilities, 87 

shared processor maintenance, 102 

shared processor programming, 88 

shared programs, 87 

Simulation Language, 8 

SL-1, 8 

SL1S command, ELLA, 71 

SMASK command, ANLZ, 44 

software check codes (see screech codes) 

Sort/Merge, 10 

source language, xii 

special shared processor, xii 

specific allocation, xii 

SRI, SR2, SR3 and SR4, xiii 

static core module, xiii 

STATS, 5 

stream-id, xiii 

(see logical device stream) 
SUM command, ELLA, 75 
SUMF1LE file, 174,190 
Summary (processor), 5 
swap hardware organization, 17 
swap-in, swap-out queues, 17 
symbiont, xiii 

symbol-code correspondences, 205 
symbolic input, xiii 
symbolic name, xiii 
SYMBOLS command, ANLZ, 45 
SYMBOL/ command, ANLZ, 45 
symbols, graphic, 202 
SYMCON, 80 
SYSCON (processor), 5 
SYSGEN, 9,xiii 
SYSTEM DIAG, 109 
system error log file (see ERRFILE) 



system generation, 9, xiii 

system integrity, 19 

system library, xiii 

system loading, 264 

system management processors, 4 

system programming facilities, 2 

system register, xiii 

SYSTEM RTPROCS, 119 

SYSTEM SIG7, 109 

SYSTEM SIG9, 109 

system start-up and initialization, 264 

system tape format, 23,24 



tape, master system, 23, 24 

task control block (TCB), xiii 

TEL, 4 

TEL, scan, 92 

Terminal Executive Language, 4 

terminal I/O, 93 

TIME command, ELLA, 77 

time-sharing, 1 

transaction processing, 2 

transaction processing facilities, 141 

list formats, 143 

M:QUEUE FPTs, 142 

M:QUEUE procedure format, 141 

M:QUEUE procedure output, 144 
TYPE command, ELLA, 78 
:TYPE command (boot-time), 27 



U 



UC command, ANLZ, 44 
UNMAP command, ANLZ, 43 
unsatisfied reference, xiii 
user processors, 87, 13 
user status queues, 15 



virtual memory, special processors, 87 
VOLINIT, 5 



w 

waiting interrupt, 119 
write error log, 189 



Xerox 560 cluster/unit matrix, 148 

Xerox standard compressed language, 201 

Xerox standard object language, 185 

Xerox standard symbols, codes, and correspondences, 202 
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